💎Updating

Learn how to update from an older version to a newer version.

Updating The Plugin

To update TaskedUltimate, all you have to do is delete the old .JAR file and put the new one inside your "plugins" folder.

Updating The Configuration

To update your configuration you can either delete your "config.yml" (which requires you to save the number under the key "task_id" and put it back in after you delete the config, as it stores how many tasks your server has) or you can add the newest update's configuration changes.

UPDATING TO 1.0.1

Replace the "command_permission" key with this.

# The permission to use the "/task help" command.
help_permission: tu.help

# The permission to use the "/task reload" command.
reload_permission: tu.reload

# The permission to use the "/task add" command.
add_permission: tu.add

# The permission to use the "/task complete" command.
complete_permission: tu.complete

# The permission to use the "/task remove" command.
remove_permission: tu.remove

# The permission to use the "/task reassign" command.
reassign_permission: tu.reassign

# The permission to use the "/task list" command.
list_permission: tu.list

# The permission to receive plugin update notifications. 
update_notification_permission: tu.update_notification

Add this under "General Plugin Settings".

# Whether or not the update checker should be used.
# If there is a plugin update, players with the "tasked.*" permission will be alerted.
update_checker: true

# The time is in "tick" a value.
# You can calculate ticks at: https://codepen.io/mrjohndoe69/pen/ExPZpNb.
# You can set this value to 0 to disable.
task_reminder_time: 6000 # 5 Minutes

Add this under the "task_created_webhook" key.

  # Whether the webhook show the updated task list or just the new task.
  # You can either use "list" or "new" here.
  # Use "new" if you reach the character limit on webhooks.
  task_display: list

Add this new section anywhere in the config.

# ###################################
# PlaceholderAPI Integration Settings
# ###################################

# The character that seperates tasks in list placeholders.
# '\n' equals a new line.
task_list_delimiter: '\n'

Add this under "Message Customization".

# The message shown to players with the permission "tasked.*" if the update checker feature is enabled.
update_notification: '&fA new version of &eTaskedUltimate &fis available!'

Add this under "Message Customization".

task_reassigned: '&fYou have reassigned the task "%task%&f" to &e%player%&f.'
task_reassigned_notification: '&fYour task "%task%&f" has been reassigned to &e%player%&f.'

UPDATING TO 1.0.2

Add this to "General Plugin Settings".

# The permission to use the "/task assume" command.
assume_permission: tu.assume

Add this under "Message Customization".

task_assumed: '&fYou have assumed the task "%task%&f" from &e%player%&f.'
task_assumed_notification: '&fYour task "%task%&f" has been assumed by &e%player%&f.'

UPDATING TO 1.0.3

Add this to "General Plugin Settings".

# The display name of the server as an identifier.
server_name: Lobby

# The permission to use the "/task convert" command.
list_permission: tu.convert

Replace "Task Storage Settings" with this.

# #####################
# Task Storage Settings
# #####################

# Determines how tasks and other data is stored.
# You can use "file" or "database" in this key.
# File storage simply stores all task information in a file.
# Database storage uses something like MySQL for advanced storage/accessing.
storage: file

# Database specific settings.
host: 'localhost'
port: 3306
database: 'db'
username: 'username'
password: 'password'

Remove "task_assumed_notification" from "Message Customization" and add this.

storage_convert: '&fYou have converted &e%amount% &ftasks to your database.'
incorrect_storage: '&cYou must use database storage to use this command.'

UPDATING TO 1.0.4

Replace all webhook footers with this.

footer: '%server% - %time% on %date% - ID %id%'

Add this to "task_created_webhook".

# For the thumbnail, you can use the placeholder %assignee_uuid% or %assigner_uuid%
thumbnail: 'https://mc-heads.net/avatar/%assignee_uuid%'

Add this to "task_completed_webhook".

# For the thumbnail, you can use the placeholder %completer_uuid% or %assignee_uuid%
thumbnail: 'https://mc-heads.net/avatar/%completer_uuid%'

Add this to "task_removed_webhook".

# For the thumbnail, you can use the placeholder %assignee_uuid% or %assigner_uuid%
thumbnail: 'https://mc-heads.net/avatar/%assignee_uuid%'

UPDATING TO 1.1.2

Add this to "General Plugin Settings"

# The permission to use the "/task debug" command.
debug_permission: tu.debug

Add this to "Task Assignment Settings".

# Actions that run after you assign a task to a player.
# You can use "%player%" and "%assignee%" as variables.
assign_actions:
  CONSOLE:
  #- give %player% diamond 1
  PLAYER: 
  #- say I assigned %assignee% a new task!
  ASSIGNEE: 
  #- say I received a task from %player%!

Add this to "Task Removal Settings".

# Actions that run after you remove a task from a player.
# You can use "%player%" and "%assignee%" as variables.
remove_actions:
  CONSOLE:
  #- give %player% diamond 1
  PLAYER:
  #- say I removed a task from %assignee%!
  ASSIGNEE:
  #- say %player% removed a task from me!

Add this to "Task Completion Settings".

# Actions that run after you complete a task from a player.
# You can use "%player%" and "%assignee%" as variables.
complete_actions:
  CONSOLE:
  #- give %player% diamond 1
  PLAYER:
  #- say %assignee% completed a task I gave them!
  ASSIGNEE:
  #- say I completed a task from %player%!

Add this to "Message Customization".

# These messages are typically to get support for plugin issues.
debug: |-
  &6&m                                                                                 &r
  &6•• &e&lDebug &8| &e&lTaskedUltimate &6••
  &eVersion &6› &f%version%
  &eStorage &6› &f%storage%
  &eWebhooks &6› &f%webhooks%
  &6&m                                                                                 &r

# These strings are various other variables you can set for messages.
empty: 'None'

UPDATING TO 1.2.0

Reset your configuraiton or update your current configuration in the "Configuration" page of the wiki for a more organized and helpful configuration file.

UPDATING TO 1.2.2

Add this configuration section anywhere in your "config.yml" file.

# #######
# Aliases
# #######

# This setting determines if your custom aliases display in tab-completion.
# Enabling this will override the plugins default command tab-completion.
alias_tab_completion: false

# The custom command argument for "/tu help".
help_alias: h

# The custom command argument for "/tu reload".
reload_alias: rl

# The custom command argument for "/tu add".
add_alias: add

# The custom command argument for "/tu complete".
complete_alias: com

# The custom command argument for "/tu remove".
remove_alias: rem

# The custom command argument for "/tu assume".
assume_alias: as

# The custom command argument for "/tu reassign".
reassign_alias: reas

# The custom command argument for "/tu list".
list_alias: l

# The custom command argument for "/tu convert".
convert_alias: con

# The custom command argument for "/tu debug".
debug_alias: d

UPDATING TO 1.2.3

No changes have to be made to update to v1.2.3.

UPDATING TO 1.3.0

The only updating that you'll need to do is configuration changes, specifcially with Discord Integration. Please cross-reference your configuration with the one on the wiki.

UPDATING TO 1.3.1

Add this configuration section to the "Discord Integration" section of your "config.yml" file.

# This section allows you to define a Minecraft username's Discord ID so that webhooks ping them.
# The format is "(MINECRAFT_USERNAME): (DISCORD_ID)".
ping_translations:
  0bviouslee: 579038191277834240