This update is for Spigot/Minecraft 1.13 to 1.16.3, and has been compiled with Spigot API 1.16.3.
The main changes in this release affect the storage of purchased double-jumps and prizes rewarded at the end of a game.
Doublejumps
===========
Purchased double-jumps are currently stored in the
config.yml file under the player's name.
Code (YAML):
doublejumps:
player1
: 7
player2
: 14
After installing this update, the plugin will use a new file,
players.yml, to store the data under the player's UUID.
Code (YAML):
aaaaaaaa-dddd-cccc-dddd-1234567890c4:
doublejumps
: 7
aaaaaaaa-dddd-cccc-dddd-1234567890d4:
doublejumps
: 14
After restarting the server, existing double-jump data can be transferred to the new file by either
a) making a manual backup of the current
config.yml, then running the command
/trsetup migrate, OR
b) use cut/paste to manually transfer the double-jumps from the
config.yml to
players.yml, remembering to change the players names to UUIDs if your server is in online mode.
Make a backup copy of config.yml before starting - just in case.
If there are no double-jumps stored in config.yml before upgrading, then no action is needed.
Rewards
=======
Optionally, rewards can now be configured (per arena) for 2nd and 3rd places in a game. The
/trsetup setreward {arena} command now has an additional prompt for first, second and third place before continuing with the reward conversation.
All types of reward are supported, money, material, XP and command, and can be configured in any combination including multiple material items.
Any existing rewards for 1st place will be unaffected by this update.
By default, rewards for all 3 places will be given provided 3 players start the game. Each place can be configured to only be rewarded if a minimum number players starts the game, for example, the 3rd place reward is only given if 5 players start. This is set by editing the
minPlayers field in {arena}.yml
Code (YAML):
reward:
minPlayers
: 0
money
: 100
xp
: 10
command
: eco give
%PLAYER% 10
material:
BLUE_WOOL:
amount
: 4
places:
second:
minPlayers
: 0
money
: 50
xp
: 100
material:
GOLD_INGOT:
amount
: 2
IRON_INGOT:
amount
: 4
third:
minPlayers
: 5
money
: 20
xp
: 0
To keep track of what rewards have been configured, there is a new command
/tr listrewards {arena}
The top 3 places are broadcast at end of game.
Reward notification is sent to the player and also logged to the console.
Other Changes
=============
Shop and head purchases are now supported in arenas with kits enabled.
The placeholders for '
playercount' and '
maxplayers',
{PS} and
{MPS} have been added to 3 existing message strings:
Code (YAML):
menutext
: '&5Players
:
&6{PS}/{MPS}'
playerjoinedtoothers
: '&c
{RANK
}&6
{PLAYER
} &7joined the arena
(&6
{PS
}&7/&6
{MPS
}&7
)'
playerlefttoothers
: '&c
{RANK
}&6
{PLAYER
} &7left the game
(&6
{PS
}&7/&6
{MPS
}&7
)'
Players joining an arena as spectators will now see the arena scoreboard until the game starts. This will make the player count and countdown visible to the spectators.
Added option to run a command on arena start and stop in
{arena}.yml
commandOnStart: ''
commandOnStop: ''
Change Log
==========
- make adding kits more efficient
- shop purchases are preserved if kits are enabled in the arena
- purchased heads are preserved when a kit is allocated
- move doublejumps out of config.yml to players.yml
- add `/trsetup migrate` command to relocate existing doublejumps
- add optional reward for 2nd and 3rd place
- display top 3 places at end of game
- remove 'playerwonbroadcast' string as made redundant by above
- remove redundant argument in getArenaCost() method
- add {PS}/{MPS} placeholders on join message
- add {PS}/{MPS} to 'menutext' string
- add `/tr listrewards` command
- add 'tntrun.listrewards' permission (default true)
- add waiting scoreboard for spectator-only players
- add option to run command on arena start and stop
- bug fix: remove blank message sent when player joins as spectator
- bug fix: prevent in-game items being removed from inventory
- bug fix: check value of tntrun.doublejumps.n when checking permission
Please report any issues found either in the discussion pages, on GitHub or Discord -
https://discord.gg/wFYSAS4