Whether due to abuse, blatant breaking of your rules, or some other reason, you will eventually find
no other recourse but to kick out a particularly troublesome player. The default command set has
admin tools to handle this, primarily
Creating a ban¶
Say we have a troublesome player “YouSuck” - this is a person that refuses common courtesy - an abusive and spammy account that is clearly created by some bored internet hooligan only to cause grief. You have tried to be nice. Now you just want this troll gone.
The easiest recourse is to block the account YouSuck from ever connecting again.
This will lock the name YouSuck (as well as ‘yousuck’ and any other capitalization combination), and next time they try to log in with this name the server will not let them!
You can also give a reason so you remember later why this was a good thing (the banned account will never see this)
ban YouSuck:This is just a troll.
If you are sure this is just a spam account, you might even consider deleting the player account outright:
Generally, banning the name is the easier and safer way to stop the use of an account – if you change your mind you can always remove the block later whereas a deletion is permanent.
Just because you block YouSuck’s name might not mean the trolling human behind that account gives up. They can just create a new account YouSuckMore and be back at it. One way to make things harder for them is to tell the server to not allow connections from their particular IP address.
First, when the offending account is online, check which IP address they use. This you can do with
who command, which will show you something like this:
Account Name On for Idle Room Cmds Host YouSuckMore 01:12 2m 22 212 237.333.0.223
The “Host” bit is the IP address from which the account is connecting. Use this to define the ban instead of the name:
This will stop YouSuckMore connecting from their computer. Note however that IP address might change
easily - either due to how the player’s Internet Service Provider operates or by the user simply
changing computers. You can make a more general ban by putting asterisks
* as wildcards for the
groups of three digits in the address. So if you figure out that !YouSuckMore mainly connects from
237.333.0.223, 237.333.0.225, and 237.333.0.256 (only changes in their subnet), it might be an idea
to put down a ban like this to include any number in that subnet:
You should combine the IP ban with a name-ban too of course, so the account YouSuckMore is truly locked regardless of where they connect from.
Be careful with too general IP bans however (more asterisks above). If you are unlucky you could be blocking out innocent players who just happen to connect from the same subnet as the offender.
YouSuck is not really noticing all this banning yet though - and won’t until having logged out and trying to log back in again. Let’s help the troll along.
Good riddance. You can give a reason for booting too (to be echoed to the player before getting kicked out).
boot YouSuck:Go troll somewhere else.
Lifting a ban¶
ban) command without any arguments and you will see a list of all currently
Active bans id name/ip date reason 1 yousuck Fri Jan 3 23:00:22 2020 This is just a Troll. 2 237.333.0.* Fri Jan 3 23:01:03 2020 YouSuck's IP.
id from this list to find out which ban to lift.
unban 2 Cleared ban 2: 237.333.0.*
Summary of abuse-handling tools¶
Below are other useful commands for dealing with annoying players.
who – (as admin) Find the IP of a account. Note that one account can be connected to from multiple IPs depending on what you allow in your settings.
examine/account thomas – Get all details about an account. You can also use
*thomasto get the account. If not given, you will get the Object thomas if it exists in the same location, which is not what you want in this case.
boot thomas – Boot all sessions of the given account name.
boot 23 – Boot one specific client session/IP by its unique id.
ban – List all bans (listed with ids)
ban thomas – Ban the user with the given account name
126.96.36.199– Ban by IP
134.233.2.*– Widen IP ban
134.233.*.*– Even wider IP ban
unban 34 – Remove ban with id #34
cboot mychannel = thomas – Boot a subscriber from a channel you control
clock mychannel = control:perm(Admin);listen:all();send:all() – Fine control of access to your channel using lock definitions.
Locking a specific command (like
page) is accomplished like so:
Examine the source of the command. The default
pagecommand class has the lock string “cmd:not pperm(page_banned)”. This means that unless the player has the ‘permission’ “page_banned” they can use this command. You can assign any lock string to allow finer customization in your commands. You might look for the value of an Attribute or Tag, your current location etc.
perm/account thomas = page_banned – Give the account the ‘permission’ which causes (in this case) the lock to fail.
perm/del/account thomas = page_banned – Remove the given permission
tel thomas = jail – Teleport a player to a specified location or #dbref
type thomas = FlowerPot – Turn an annoying player into a flower pot (assuming you have a
userpassword thomas = fooBarFoo – Change a user’s password
account/delete thomas – Delete a player account (not recommended, use ban instead)
server – Show server statistics, such as CPU load, memory usage, and how many objects are cached
time – Gives server uptime, runtime, etc
reload – Reloads the server without disconnecting anyone
reset – Restarts the server, kicking all connections
shutdown – Stops the server cold without it auto-starting again
py – Executes raw Python code, allows for direct inspection of the database and account objects on the fly. For advanced users.
evennia changepassword <username> entered into the command prompt will reset the
password of any account, including the superuser or admin accounts. This is a feature of Django.