Utility, signs and powertools

modules/utility.yml — the largest module, 38 commands.

The commands#

Aiming one at somebody else needs the same permission with .others on the end, for example chorus.utility.heal.others.

Portable screens#

All chorus.utility.<command>:

/craft · /anvil · /smithingtable · /grindstone · /stonecutter · /loom · /cartography · /enchanting · /enderchest

Settings#

utility:
  heal:
    extinguish: true
    clear-effects: false
    restore-food: false

  feed:
    saturation: 20.0

  fix:
    allow-all: true
    blacklist: [ ]

  disposal:
    rows: 4

  speed:
    maximum: 10.0

  invsee:
    filler: GRAY_STAINED_GLASS_PANE
    refresh-ticks: 10

  top:
    allow-in-nether: false

  near:
    default-radius: 100
    max-radius: 500

  fireball:
    blast: 0.0
    incendiary: false

  motd:
    show-on-join: true

/invsee and /ecsee#

They are live. What you drag into the window lands in the other player's inventory straight away, and what they pick up shows in yours.

They are read-only until the viewer also holds chorus.utility.invsee.edit or chorus.utility.ecsee.edit.

chorus.utility.invsee.exempt protects a player from both.

/smite and /fireball#

/smite with no name strikes whatever you are looking at.

/fireball throws fireball, small, dragon, skull, arrow, snowball, egg or pearl. What an explosive one does where it lands is in the config, not the player's to decide, so it starts as a firework rather than a way to make a crater.

Service signs#

Signs that do what a command does.

[Kit]            [Gamemode]       [Free]           [Repair]
starter          creative         64               all
                                  bread
100              0                                 50

The first line is what the sign does, the middle lines are the arguments, and the last line may be a price.

The kinds:

[Heal]  [Feed]  [Repair]  [Disposal]  [Workbench]  [Enchant]  [Gamemode]
[Kit]   [Balance]  [Spawn]  [Mail]  [Time]  [Weather]  [Spawnmob]  [Free]

Everything but [Free] runs the command as the player who clicked it, so that command's permission, cooldown and price all still apply. A [Kit] sign cannot hand out a kit somebody is not allowed to take, and it cannot skip the cooldown either.

The price on the sign is on top of whatever the command itself charges, and is only taken when the command actually goes through.

[Free] is the odd one: it hands over an item rather than running a command. Amount on the second line, item on the third.

Making one needs chorus.signs.create.<kind>; using one needs chorus.signs.use.<kind>. utility.signs: false turns the whole thing off.

There is also [Warp] (in Warps and spawn) and [Buy], [Sell] and [Shop] (in Shops).

Powertools#

/powertool <command> ties a command to the item in your hand. Every item of that kind then runs it, for anybody holding chorus.utility.powertool.

/powertool heal %player%     a stick that heals whoever you right-click
/powertool add smite         and smites them too
/powertool list              what this item runs
/powertool clear             untie this item
/powertool clear all         untie everything

The command runs as you, so a powertool can never do something you could not have typed. The permission is checked on the click rather than when it was tied, so a demoted staff member's wand stops working at once.

%player% means whoever you right-click, and a command that needs one says so instead of running on nobody.

One item holds up to five commands, and they are kept between sessions.

/powertooltoggle stops all of them without forgetting any, for when you want to build with a tool that has a command on it.

The message of the day#

motd.txt and info.txt in the plugin folder are read by /motd and /info.

Lines are written the way messages.yml is — <gray>, <gradient:#a06bff:#e0c3fc> or plain &7 — and %player%, %world%, %online% and %max% are filled in for whoever is reading.

Chapters#

# This is a note to you. Never shown.

<gray>Everything above the first chapter is what a bare /info shows.

#rules
<bold>Rules
<gray>1. Be decent.

#staff chorus.admin
<gray>Only people holding chorus.admin can read this chapter.

Everything above the first chapter is what a bare /info shows, along with a list of the chapters that reader is allowed to open.

Nine lines fill a page and the rest go on /info rules 2.

utility.motd.show-on-join: false stops the motd being sent as players arrive.

Permissions#