FTB Utilities

Frequently Asked Questions

Information about chunk claiming Here

Information about ranks Here


The mod isn't working, help!

Make sure Sponge, Spigot, LuckPerms or any other non-Forge mod/plugin/loader isn't installed! FTB Utilities doesn't work well with those. If not, make an issue or ask question on discord in #chat-and-support channel.


How to use ranks/permissions?

Read the Ranks page

You can find the permission list here


Does this mod work with Sponge / Spigot / Paper / any other non-Forge plugin system?

Poorly. It's best to not use those when if you use FTBU or not use FTBU if you want to use those mods.


How to allow player to use an OP command?

Set command.name permission to true. If command is from mod, then it will have modid in it. For example, /tp will be command.tp but /spawn will be command.ftbutilities.spawn.


Where can I see list of all command nodes?

Command nodes will always be command.modid.commandname. For example, /home command comes from FTB Utilities mod, so it will be command.ftbutilities.home. Vanilla commands don't have a mod ID so they are just command.tp or command.stop.

If you have Aurora mod installed, you can view them from http://localhost:48574/ftb-utilities/ranks/commands in browser.


Where can I see list of all custom permission nodes?

You can find custom permission node list here: https://gist.github.com/LatvianModder/580500873676c5252c72957fd93e4a28

If you have Aurora mod installed, you can view them from http://localhost:48574/ftb-utilities/ranks/permissions in browser.


How to change max homes for players?

Set ftbutilities.homes.max permission to 30 or any other number you want.


How to change max claimable chunks for players?

Set ftbutilities.claims.max_chunks permission to 30 or any other number you want.


How to change max loadable chunks for players?

Set ftbutilities.chunkloader.max_chunks permission to 30 or any other number you want.


How to make chunks load only when player is online?

Set ftbutilities.chunkloader.load_offline permission to false.


How to claim spawn chunks / different area?

1. /team create_server_team spawn - Create spawn team
2. /team settings_for spawn - Edit spawn team settings
3. /chunks claim_as spawn 5 - Claim 5 chunk radius from your position as spawn team


How to change cooldown & warmup timers for /home to 0 seconds?

Change ftbutilities.homes.cooldown permission to 0s to change the timer that prevent you from using command after teleport.

Change ftbutilities.homes.warmup permission to 0s to change the timer that prevents you from teleporting if you move


Command List

Argument types: <required>, [optional]

Chunk Claiming

FTB Utilities allows you to protect your base with Claimed Chunks. Claimed chunks will be by default accessible to your team and team allies. You can also disable explosions and fake player interactions.

To open the GUI, you must click on the Claimed Chunks sidebar button:

68747470733a2f2f692e696d6775722e636f6d2f524631656a4d532e706e67.png 68747470733a2f2f692e696d6775722e636f6d2f3137563441556d2e706e67.png

You can drag mouse to claim/unclaim/load/unload larger area at once.

68747470733a2f2f692e696d6775722e636f6d2f346a38736b47692e706e67.png

You can use commands too:

Ranks

FTB Utilities ranks will be disabled if Sponge is present and will not work. Do not report issues if you have Sponge.

Terminology


Ranks

Instead of assigning permissions to every user individually, we have groups of permissions, which can then be assigned to a user as a whole.

For example, in my admin rank, I might add permission to ignore claims, and then assign users to the admin rank. This means that they will get all of the permissions from admin, plus any they have themselves.

Players can have multiple ranks, similar to Discord roles. The rank with higher power will take priority if two permissions are the same.

Permission

On your server, there will be a number of features, commands, and functionality which is added to the game. Most of these actions have a permission associated with them, so you can control which users have access to each feature or command.

A permission is just a string, and is separated into parts using periods. For example, ftbutilities.back.infinite is the permission to use the /back command infinitely. Obviously we don’t want all users to have access to this, so we only give it to some users.

The string that represents a certain permission is also sometimes called a "permission node" or just "node" for short.

Commands


There are a few utility commands for ranks, so you don't have to do everything in the configs.

Config


Enabling Ranks

They are enabled by default, but if they aren't, set Enabled & Override Chat to true in config/ftbutilities.cfg.

While //Comments are used in examples, they might not work in actual files, and will be removed by mod.

The ranks file is in local/ftbutilities/ranks.txt.

Permissions

To add permission to rank simply write the node below rank definition and add value after : 

Command Permissions

Command permissions are special and generated every time server loads. For example /heal permission would be command.ftbutilities.heal, because it was added by FTBUtilities mod and command name is heal. Tree commands are supported, e.g., /ranks get LatvianModder would be command.ftbutilities.ranks.get. Vanilla commands don't have a mod name, so /gamemode would be command.gamemode.

Example:
[some_rank]
power: 20
ftbutilities.claims.block.edit.minecraft.sand: true
ftbutilities.claims.block.edit.minecraft.stone: false
ftbutilities.homes.max: 10
ftbutilities.claims.max_chunks: 30
ftbutilities.chunkloader.max_chunks: 15
command.ftbutilities.heal: true

Will allow the rank to break sand in claims and use /heal, and deny the rank to break stone in a claims.

See Example Config for a larger example file.

Default Rank Assignment

Default ranks aren't required, but it's still recommended to use them. Add default_player_rank: true or default_op_rank: true inside [rank].

They basically tell what rank to use when player doesn't have any rank assigned.

Example
[player] // This rank will be used for players that don't have a rank assigned
power: 1
default_player_rank: true
command.heal: true

[admin] // This rank will be used for OPs that don't have a rank assigned
power: 1000
default_op_rank: true
command: true // Allows to use all commands

Chat Formatting

To change player name formatting from default <Player> to something more interesting, use ftbutilities.chat.name_format permission.

All permissions that you can use to modify chat message text:

Example
[admin]
ftbutilities.chat.name_format: <&2Admin &l{name}&r>
ftbutilities.chat.text.italic: true

Text Admin be added before player name with a space and both that text and name will be dark green, but the player name will be bold.

The result will be <Admin LatvianModderHello!, where:

Minecraft color codes:

Color-codes.png

File Structure

Files that are inside local/ftbutilities/:

Example config
[player] // Make this the default rank for players
power: 1
default_player_rank: true
ftbutilities.claims.block.edit.gravestone.gravestone: true // Allow all players to break gravestones (this is already the default in mod, so you don't actually need to add it)
command.ftbutilties.home: false // Deny players from using homes
command.stop: true // Allow players to use vanilla /stop command
ftbutilities.claims.max_chunks: 30 // Set max claimable chunks to 30

[vip]
power: 10
ftbutilities.claims.max_chunks: 80 // Set max claimable chunks to 80, overrides player
ftbutilities.chunkloader.max_chunks: 40 // Set max loadable chunks to 80
ftbutilities.chat.name_format: "<VIP &l{name}&r>" // Change name to bold letters and will have VIP in front of the name

[admin] // Make this the default rank for OPs
power: 1000
default_op_rank: true
command: true // Give admins all commands
ftbutilities.chat.name_format: "<&2{name}&r>" // Name color will be dark green

Badges

What are badges?

Badges are little square icons on your chest, like a police badge. They also glow in dark. So that's pretty cool, I'd say.

Example:

2017-04-21_14_12_38.png