- What permissions do you give others to modify and/or maintain your submission?
- Modify: YES - Maintain: YES - I give permission for my entire submission to be modified by others or used in their own work. I give permission for my entire submission to be maintained by others as well.
Provides various commands to allow players and server admins to control what characters other people can use.
Modules:
No Core Chars (NoCoreChars.lua)
Allows you to prevent core (vanilla) characters from being used, while selectively allowing certain characters. If a player is using a disallowed character they will be assigned a random allowed character.
pvsc_allowcoreskins
Boolean console variable which determines whether core characters are allowed. Default value: yes.
Examples:
pvsc_whitelistcoreskin
Add a character to the whitelist, allowing them to be used regardless of whether core character banning is enabled. Takes a skin's ID.
Example:
pvsc_unwhitelistcoreskin
Removes a character from the whitelist. Takes a skin's ID.
Example:
pvsc_clearcorewhitelist
Clears the core character whitelist, returning to default behaviour where no core characters are allowed if core character banning is enabled. Takes no arguments.
Example:
pvsc_listcorewhitelist
Shows whether core character banning is enabled, and which characters are whitelisted if so. Takes no arguments. Does not require admin permissions.
Example:
Current limitations:
Set Player Skin (SetPlayerSkin.lua)
Allows you to forcibly set a player's character to whatever you like.
pvsc_setplayerskin
Picks a player and sets their character to a chosen skin. Takes 3 arguments.
Player names are not case-sensitive. Player names with a space in them should be wrapped in quotes.
Current limitations:
Skin Ban (SkinBan.lua)
Allows individual character to be disallowed, assigning a random skin to players using a disallowed one.
pvsc_doskinban
Boolean console variable which determines whether skin banning is in effect. Default value: no.
Examples:
pvsc_banskin
Bans a character, preventing them from being used if character banning is enabled. Takes a skin's ID.
Example:
pvsc_unbanskin
Unbans a character. Takes a skin's ID.
Example:
pvsc_clearbannedskins
Clears the ban list, allowing all characters to be used. Takes no arguments.
Example:
pvsc_listbannedskins
Lists all characters that are currently banned. Takes no arguments. Does not require admin permissions.
Example:
Current limitations:
Planned features:
Modules:
No Core Chars (NoCoreChars.lua)
Allows you to prevent core (vanilla) characters from being used, while selectively allowing certain characters. If a player is using a disallowed character they will be assigned a random allowed character.
pvsc_allowcoreskins
Boolean console variable which determines whether core characters are allowed. Default value: yes.
Examples:
pvsc_allowcoreskins nopvsc_allowcoreskins 0pvsc_whitelistcoreskin
Add a character to the whitelist, allowing them to be used regardless of whether core character banning is enabled. Takes a skin's ID.
Example:
pvsc_whitelistcoreskin heavymagicianpvsc_unwhitelistcoreskin
Removes a character from the whitelist. Takes a skin's ID.
Example:
pvsc_unwhitelistcoreskin vectorpvsc_clearcorewhitelist
Clears the core character whitelist, returning to default behaviour where no core characters are allowed if core character banning is enabled. Takes no arguments.
Example:
pvsc_clearcorewhitelistpvsc_listcorewhitelist
Shows whether core character banning is enabled, and which characters are whitelisted if so. Takes no arguments. Does not require admin permissions.
Example:
pvsc_listcorewhitelistCurrent limitations:
- Bots are not renamed when their character is changed. This limitation is imposed by the Lua API itself.
- If a player is forced to change their character due to their original choice being banned, unbanning their original character does not automatically restore them.
- Undefined behaviour occurs when core characters are disallowed but no modded characters are loaded.
- There is no method to dynamically determine how many core characters are loaded; the script needs to be updated every time core characters are added or removed.
Set Player Skin (SetPlayerSkin.lua)
Allows you to forcibly set a player's character to whatever you like.
pvsc_setplayerskin
Picks a player and sets their character to a chosen skin. Takes 3 arguments.
- Argument 1:
nameornum. Determines the method used to select a player.nameselects a player by their name (as it appears on the tab menu or intermission screen).numselects a player by their node. - Argument 2: If argument 1 was
name, this should be the name of the desired player. If argument 1 wasnum, this should be the node number of the desired player. - Argument 3: The ID of the skin you want the chosen player to use.
pvsc_setplayerskin name Sonic knucklespvsc_setplayerskin name "Metal Knuckles" eccopvsc_setplayerskin name tAiLs metalsonicpvsc_setplayerskin name PencilVoid mechasonicpvsc_setplayerskin node 9 amyPlayer names are not case-sensitive. Player names with a space in them should be wrapped in quotes.
Current limitations:
- Bots are not renamed when their character is changed. This limitation is imposed by the Lua API itself.
Skin Ban (SkinBan.lua)
Allows individual character to be disallowed, assigning a random skin to players using a disallowed one.
pvsc_doskinban
Boolean console variable which determines whether skin banning is in effect. Default value: no.
Examples:
pvsc_doskinban yespvsc_doskinban 1pvsc_banskin
Bans a character, preventing them from being used if character banning is enabled. Takes a skin's ID.
Example:
pvsc_banskin bombpvsc_unbanskin
Unbans a character. Takes a skin's ID.
Example:
pvsc_banskin motobugpvsc_clearbannedskins
Clears the ban list, allowing all characters to be used. Takes no arguments.
Example:
pvsc_clearbannedskinspvsc_listbannedskins
Lists all characters that are currently banned. Takes no arguments. Does not require admin permissions.
Example:
pvsc_listbannedskinsCurrent limitations:
- Bots are not renamed when their character is changed. This limitation is imposed by the Lua API itself.
- If a player is forced to change their character due to their original choice being banned, unbanning their original character does not automatically restore them.
Planned features:
- Automatically save and load configuration
- Until this is added, console scripts can be used to semi-automate the process of configuring the mod
- Allow followers to be banned
