clusterconsultant/mentaledge.fsu-fvnk

A port of fvnkhead's server mod to add some of its commands to FSU.

FSU-fvnk

A fork merging many of the commands in fvnk's server mod into FSU, plus some extra things I did. Many similar commands merged, logical aliases set, chat messages made uniform etc.

Based on the fantastic Fifty's Server Utilities by Fifty, with lots of fvnk's server mod sprinkled in.

Fully FSU compatible! This is a drop-in FSU core replacement. Compatible with my Better Team Balancing and MentalreBalance mods, the former of which I highly recommend to all server hosts.

If you intend to create new FSU compatible modules, the documentation on the FSU thunderstore page still applies, as I have left the actual API for command registration completely untouched. The only addition being my chat color themeing. If you use it, MentalEdge.theme must be installed alongside any module relying on it. This enables using modules created to benefit from the color themeing, with normal FSU as well.

For config, refer to the commented convars in mod.json.

Note: MentalEdge.theme needs to be installed along with FSU-fvnk even if you do not intend to modify chat colors.

New in 1.0.2

• Lockdown now turns off if no admins are on
• Admins are now automatically logged out on disconnect
• Option to allow admin login to persist across matches
• Added option for random map rotation
• !help now accepts "all" argument which will print all pages
• Denser pagination for !help, items per page increased to 8, displayed in two horizontal rows rather than one vertical column
• Added !getuid command
• Mutes/Kicks can now persist, and be set to expire within a configurable number of matches
• Same as 1.0.1 but includes a comment next to admin login persistence in mod.json, and disables it by default

Screenshots

Taken using default colors, any and all of them can be set to whatever you'd like by editing theme.nut in MentalEdge.theme.

Available Commands

• !kick - vote kick
• !extend - extend map
• !yell/announce - announce something using HUD
• !lockdown - prevent new connections to server from all except admins
• !ban - UID ban a player
• !login/!logout - log in/out as admin
• !mute/!unmute - mute, unmute a player
• !getuid - get the UID of a player
• !help - display commands, or the instructions of one
• !name - display server name
• !owner - display server host
• !mods - list mods
• !rules - display rules
• !discord - display server discord details
• !switch - switch teams, or, if admin, switch someone elses team
• !nextmap - vote for the next map or view current maps in rotation
• !skip - skip map
• !slay - slay a player/team/everyone
• !freeze - freeze a player
• !stim - give someone stim
• !salvo - give someone flight core
• !tank - make someone tanky
• !fly - noclip
• !marvn - spawn a marvin
• !grunt - spawn a grunt

Also of course still includes the spam handling from FSU.

Comes with some non-command features from fvnks server mod, such as killstreak/pitfall/marvin kill announcements. These can be found and enabled/disabled in mod.json.

Additions

• Added commands: !ban, !getuid
• Support color themeing (MentalEdge.theme)
• Admin QOL/security improvements
  • Added option to require admins log in, to access chat
  • Added option to allow admin login to persist across matches
  • Admins are now automatically logged out on disconnect
  • !lockdown is disabled automatically if no admins are on
• Replaced map votes with !nextmap from fvnks server mod
  • Votes can be submitted any time during match, for any map
  • Added option to prevent votes for recently played maps or current map
  • Merged and aliased with !maps command, to view maps, simply run the same command without a vote argument
  • Option for random map rotation
• Improved pagination
  • Pages fit one more item
  • Denser pagination for !help, 8 items per page, displayed in two horizontal rows rather than one vertical column
  • Page number moved to first line
• Improvements to commands
  • !switch now kills if used while alive
  • !switch can be used on other players if admin and logged in
  • !usage command has been merged/aliased with !help
  • !help/!usage now recognizes command abbreviations/aliases
  • !help now accepts "all" argument which will print all pages
• Mutes/Kicks can now persist, and be set to expire within a configurable number of matches

Removed

• FSU map voting - !nextmap provides the same functionality in a better way
• FSU player balancing - I recommend using my Better Team Balancing add-on to cover this

ANSI color codes

8bit ANSI color codes are in welcome and broadcast messages written using a %-sign representing the "\x1b[38;5;" part of the color code, this was changed from original FSU in order to enable setting welcome message and broadcast message convars in docker-compose. An example of a welcome message would be:

"Run %113m!help <page>%15m to list available commands"

The !help and <argument> portion would get higlighted. Color codes can be found here. To use a color, take its number and add "%" in front and "m" after. For red text, it would be "%196m", and to go back to white, use "%15m".

MentalEdge.theme contains the file "theme.nut" and needs to be used regardles of whether you want to customize the colors. If you do want to, in it you can set the color themes for all other messages by simply editing the color codes already there. The colors will apply to any of my installed mods that are used.