# Updating

## **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.

<details>

<summary><strong>UPDATING TO 1.0.1</strong></summary>

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".

<pre><code># 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
<strong>
</strong><strong># The time is in "tick" a value.
</strong># 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
</code></pre>

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.'
```

</details>

<details>

<summary><strong>UPDATING TO 1.0.2</strong></summary>

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.'
```

</details>

<details>

<summary><strong>UPDATING TO 1.0.3</strong></summary>

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.'
```

</details>

<details>

<summary><strong>UPDATING TO 1.0.4</strong></summary>

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%'
```

</details>

<details>

<summary><strong>UPDATING TO 1.1.2</strong></summary>

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'
```

</details>

<details>

<summary><strong>UPDATING TO 1.2.0</strong></summary>

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

</details>

<details>

<summary><strong>UPDATING TO 1.2.2</strong></summary>

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
```

</details>

<details>

<summary><strong>UPDATING TO 1.2.3</strong></summary>

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

</details>

<details>

<summary><strong>UPDATING TO 1.3.0</strong></summary>

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.

</details>

<details>

<summary><strong>UPDATING TO 1.3.1</strong></summary>

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
```

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.obviouslee.dev/taskedultimate/updating.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
