Jump to content

ServerUtilities: Difference between revisions

m
Remove quotation mark from permissions & elaborate on some details
m (Cleanup: Ranks info wanted)
m (Remove quotation mark from permissions & elaborate on some details)
Line 3:
 
== Installation ==
Download the latest version from [https://github.com/GTNewHorizons/ServerUtilities/releases Github]. Pick the version that does not have any -source or -dev suffixes, just a plain ServerUtilities {version number}.jar file. Add the .jar to the <code>/mods/</code> folder in the instance. For servers, it must be added to both server ''and'' client-side. Players migrating from FTBUtilities & FTBLibrary should remove those mods in order to avoid issues. For Single Player, it only needs to be in the client. When properly installed, there should be new buttons to the left of the inventory GUI. Players migrating from FTBUtilities can archive their <code>/local/</code> folder after successfully running ServerUtilities and ensuring everything works as expected. There is no separate library mod needed for ServerUtilities.
 
=== Icons ===
Line 15:
 
== Permissions ==
One of SU's core features is permissions management. It can be used to set a variety of different player ranks that allow/disallow certain actions and commands without having to assign each individual player. Players can have one or more ranks at once, andin willwhich havecase the greatestrank allowedwith highest power forwill eachtake priority over any overlapping permission amongstnodes themfrom ranks with lower power.
 
A full list of current permissions and commands can be generated with <code>/dump_permissions</code>. This file contains every command available to players, who can use it, and its source. ServerUtilities own permissions are also listed, such as warp/teleport cooldowns and warmups, restrictions on block placement/use in claimed areas, and maximum allowed claims/homes. This dump includes the node designations for commands (command.{mod}.{keyword}) which are needed to assign specific permissions to ranks.
 
* Ranks config: <code>/your_instance/serverutiltiesserverutilities/server/ranks.txt</code>
** <code>"serverutilities.chunkloader.max_chunks":</code> Change the total chunkloaded chunks per player.
** <code>"serverutilities.claims.max_chunks":</code> Change the total number of claimed chunks per player.
** <code>"serverutilities.homes.max":</code> Change the allowed number of /home registrations.
* Player list: <code>/your_instance/serverutiltiesserverutilities/server/players.txt</code>
* [https://feedthebeast.notion.site/Ranks-003fd40c2de247aba4730faa7514e12a Sample Ranks and configurations are the same as for FTBUtilities]
 
== Claimed Chunks ==
[[File:SU claim map.png|thumb|right|alt=Top down map of a canyon and desert split by a wide river. The lower left area is mostly overlaid by blue chunks, the central area has a blobby red outline. Five buttons are on the right, a green checkmark, green circulating arrows, two no entry circles with white horizontal bars, and a blue circle with an "i" character.]]
Open in-game inventory, click on the map icon ([[File:FTBUtilities Map Icon.png|16px]]) to the left, then left click on chunks to claim. Claimed chunks will be overlaid with the player's team color, which can be changed from <code>My Teams > Settings > Color</code>. Right-click to unclaim a chunk. Click-drag to claim/unclaim multiple chunks as once. CTRL can be held while dragging to claim/unclaim in a large square.
 
==== Chunkloading ====
Shift+click on any chunk to claim and chunkload it. Shift right-click to keep the claim but no longer chunkcloadchunkload. Hold Shift and click-drag to claim & load multiple chunks at once. Shift+right click-drag unloads multiple chunks, but retains the claim. There are buttons on the right side for unclaiming all Overworld chunks and all chunks in every dimension.
 
Chunk Claim data is stored at <code>/''your_instance''/saves/''your_world''/serverutilities/teams/claimedchunks/''player_name''.dat</code>
6

edits

Cookies help us deliver our services. By using our services, you agree to our use of cookies.