Citrus

[pollyzoid]

[release][b]Name:[/b] Citrus

[b]Description:[/b] Mod for server administration and management

[b]Created By:[/b] Conna, errors fixed and improved by Polly (me)

[b]Screenshot:[/b]
[img_thumb]http://kotsc.info/pics/citrus.jpg[/img_thumb]
[/release]
[release][b]List of plugins and descriptions:[/b]
[list]
[*]Achievements - No description really...
[*]Advertisments - Insert advertisments to be displayed with set interval (1 minute by default)
[*]Attributes - Set health, armor and weapons for every group
[*]Circles - Display circle under every player
[*]Commands - Some basic commands, like rcon
[*]Deathwatch - Watch your death from ragdoll's eyes
[*]EntityGuard - Prop protection
[*]Entity Limits - Group-specific entity limits (props, ragdolls, etc.)
[*]Fun and Useful-pack - Adds commands for parenting and setting spawnpoint
[*]Ghost - Possess any prop!
[*]GunGame - Very simple CS-like minigame
[*]Hide and Seek - Another minigame
[*]Informationbar - Display a bar on middle-top of the screen (Look at the screenshot)
[*]Languages - Create, speak and teach your own languages!
[*]Names - Display names and titles above players
[*]Playergrabbing - Grab players with your physgun
[*]Player Management - Commands for player management
[*]Player Punishment - Commands for punishing players
[*]Points - Gather points over time and spend them on upgrades
[*]Promotions - Automatic promotions after a set amount of hours
[*]Redo - Undo your undo!
[*]Restrict Noclip - Restrict noclip to specific access groups
[*]Restrict SEnts - Restrict SEnts to access groups
[*]Restrict SWeps - Etc.
[*]Restrict tools - Etc.
[*]Rules - Display rules on player spawn
[*]Sandbox - Easy management of few sbox_ commands and limits
[*]Scoreboard - Adds sui_scoreboard as a plugin
[*]Tag - Another minigame!
[*]Teams - Create teams for groups, with colors and everything! (Use this for team names on scoreboard)
[*]Titles - Set your title to display above you
[*]Translate - No idea to be honest.
[/list]

[b]And other plugins I included separately:[/b]
[list]
[*]MySQL plugins for viewing bans, logs and reports. ([url=http://kotsc.info/gmod/logs]Example[/url])
[*]Custom chatbox made by Conna, requires some tweaking of hooks to get working
[/list]
[/release]
[release]
[b]HOW-TO:[/b]
[list=1]
[*]Upload the citrus + materials directory included to your garrysmod directory.
[*]To configure Citrus go to garrysmod/addons/citrus/lua/citrus/server/configuration/
and edit the files there.
[*]To make yourself a 'Super Administrator' you need to add yourself as 'superadmin' in
garrysmod/settings/users.txt.
[/list]
[b]Most useful commands are /commands and /quickmenu in chat or 'citrus commands' or 'citrus quickmenu' in console.[/b]
[/release]
[release]
[b]Download:[/b]
[indent][b]garrysmod.org:[/b]
[url=http://www.garrysmod.org/downloads/?a=view&id=71145][img]http://www.garrysmod.org/img/?t=dll&id=71145[/img][/url]
[b]Mirror: [url]http://kotsc.info/lua/citrus.zip[/url][/b][/indent]
[/release]

[Darastrix]

Good job fixing it I guess.

[find me]

[QUOTE=Darastrix;15679668]Good job fixing it I guess.[/QUOTE]

When was it broken?

[russduck]

What is

"Set Promotion Hours"

Saw it in the screenshot, wondering what it is :sax:

[Ice]

[QUOTE=russduck;15680158]What is

"Set Promotion Hours"

Saw it in the screenshot, wondering what it is :sax:[/QUOTE]

It's where players move up in ranks depending on how much time they've spent on the server. The TrickysTutorials.com servers once had ServerSecure, but I'm not sure if I want to download Citrus; I've heard good things about it but it looks like something for clan servers more than for personal use.

[Darastrix]

[QUOTE=find me;15680133]When was it broken?[/QUOTE]

I don't know, just trying to be polite.

[DiscoBiscuit]

But Conna made this.
It's one of my favorite admin mods.

[Gurra]

Have you fixed the bug when you ban some one it starts to lagg like hell?

[Lego399]

I'm gonna use this on my server.

[yakahughes]

This looks really complicated, no?

[Pawnstick]

citrus sucks

[A_DVD_OF_COOL_R]

[QUOTE=Pawnstick;15694688]citrus sucks[/QUOTE]

Much like your posting.

[nibb1es]

Can I ask, what was fixed? I remember old Citrus worked fine apart from players.txt located garrysmod/data caused server to lag spike every 40 seconds because it got to like 50mb+

[killer911pt]

This has to be one of the prettiest admin UI's i have ever seen

[vasyadeagle]

Wow, i'm gonna trying this!
Thanks for this EPIC Admin Mod

[AncientFryup]

Awesome mod I have it on my server runs great!

[Zarfa]

I have done the users.txt thing but I still cant make myself admin ... How to do that ?

[fudgek_v2]

Is it possible to set the sui_scoreboard to show the correct titles of the players rank and / or add colors for the ranks?

[pollyzoid]

[QUOTE=fudgek_v2;15747096]Is it possible to set the sui_scoreboard to show the correct titles of the players rank and / or add colors for the ranks?[/QUOTE]

Enable the plugin Teams.

[Jake1305]

Look alright, I guess. Good work on fixing it up.

[Darkchaos]

Conna (kuromeku) says can you update the site in the readme.txt to kuromeku.com and can he have a tad bit more credit than you're giving him.

[ss2man44]

Wow, ServerSecure just got owned...

Looks nice but I don't remember very much being wrong with Citrus.

[samwilki]

What have you actually changed, go on enlighten me.

[Utriax]

[QUOTE=Zarfa;15739957]I have done the users.txt thing but I still cant make myself admin ... How to do that ?[/QUOTE]

Try and do "Rcon_password [Rcon pass]" in your console while in game(in your server) and then do the command "Rcon Citrus setgroup <player name> <Rank>"

For example:

Rcon Citrus setgroup Utriax Admin

or

Rcon Citrus setgroup Utriax superadmin

i did

"Rcon Citrus setgroup Utriax Owner" since i made an extra group to the groups called "Owner" , so one of the first 2 should work.

Hope that will clear some up :D (and if i am wrong please do correct me)

[CombineGuru]

I use ULX now.
I might switch to this though, I like the way that you can collect points.

[DiscoBiscuit]

Can you give a list on what you actually changed? Or are you just re-releasing Conna (kuromeku)'s work?
Do custom emotes work now?

[LuaStoned]

[QUOTE=DiscoBiscut;15779463]Or are you just re-releasing Conna (kuromeku)'s work?[/QUOTE]

You got it! :D

[pollyzoid]

[QUOTE=DiscoBiscut;15779463]Can you give a list on what you actually changed? Or are you just re-releasing Conna (kuromeku)'s work?
Do custom emotes work now?[/QUOTE]

In this version I got couple bugs fixed and added some plugins. I'm working on a new version which will change the serialization used by Conna to GLON, which is at least supposed to be faster. I'll also be adding a custom HUD and the scoreboard will have (also Conna's) GMA custom avatars integrated.

I'll take a look at the chatbox and see what I can do...

At this point it's more of a re-release than a big improvement, but I hope that'll change soon :v:

If you have any requests for plugins, new commands, etc. just post them here.

[Kingof🅱east]

Hey. The D3vine once ran Citrus on the build server. The problem (as stated above) was that the players.txt did get HUGE. It was because of random slashes being put into the file somehow. I made a fix for it, you might want to include it.
In lua/citrus/server/core/libraries/sv_groups.lua, replace function citrus.Groups.Initialize(pl) with:

-- Initialize.
function citrus.Groups.Initialize(pl)
	local tmpplayers = file.Read("citrus/players.txt")
	local tmp2players = string.Replace(tmpplayers, string.char(92), "")
	file.Write("citrus/players.txt", tmp2players)
	file.Write("citrus/backups/playerslastclean.txt", tmp2players)

	for k, v in pairs(player.GetAll()) do
	v:ChatPrint("Player logs have been cleaned and reloaded.")
	end
	timer.Create("CleanPl", 3600, 0, citrus.Groups.Initialize)

	citrus.Groups.Players = citrus.Utilities.TableLoad("players.txt") or {}
	
	-- For Loop.
	for K, V in pairs(citrus.Groups.Players) do
		if (!V.IPAddress) then V.IPAddress = "N/A" end
	end
end

This would fix the players file every hour (I think?) if it were to start getting corrupted. The only reason it should lag from then on is if you actually get enough legit data in that file to make it lag.

EDIT: Bans also did this sometimes. lua/citrus/server/core/libraries/sv_bans.lua, function citrus.Bans.Initialize()

-- Initialize.
function citrus.Bans.Initialize()
	local tmpbans = file.Read("citrus/bans.txt")
	local tmp2bans = string.Replace(tmpbans, string.char(92), "")
	file.Write("citrus/bans.txt", tmp2bans)
	file.Write("citrus/backups/banslastclean.txt", tmp2bans)

	for k, v in pairs(player.GetAll()) do
	v:ChatPrint("Ban logs have been cleaned and reloaded.")
	end
	timer.Create("CleanBan", 3600, 0, citrus.Bans.Initialize)
	citrus.Bans.Stored = citrus.Utilities.TableLoad("bans.txt") or {}
end

I honestly don't know if you've already fixed this (I haven't looked) so please don't criticize me.

[pollyzoid]

[QUOTE=KingofBeast;15781238]-snip-[/QUOTE]

Thanks, I haven't found that bug since my server isn't very popular...
I'll include this fix in the next version.