Frequently Asked Questions

1. Where do daily random tasks come from?

Before version 1.4.1

The plugin will perform logical judgment every hour after startup (as long as today's daily task list hasn't been generated, it will keep judging)
1. Tasks have been created
2. Task count configuration in config.yml is greater than 0
3. Generate daily task list, and assign tasks to all online players
4. When players log in, they will automatically get the daily task list, those already obtained won't be obtained again
5. Daily random tasks theoretically refresh between 0-1 o'clock (if you have created tasks)
6. Can use command /plk getToday to immediately execute once, repeated execution won't repeat the acquisition

After version 1.4.1

Perform logical judgment at 00:00 to generate daily tasks
After first configuration, can use command /plk getToday to immediately execute once, repeated execution won't repeat the acquisition

After version 1.6.0

Automatically perform logical judgment at 00:00 to generate daily tasks, only draws from type everyday
/plk getToday command use with caution, using this command clears previous player task data and regenerates today's random tasks (won't affect created task list)
For performance, now when generating new daily tasks each day, all old historical task data will be cleared

After version 1.11.0

Daily players will automatically get daily tasks when logging into the game
At 00:00, yesterday's tasks will be deleted and today's tasks will be regenerated
(only draws from type everyday)

2. Can't task requirement items and reward items be translated?

1.13+ versions will automatically translate according to configured language type

Supports full language translation, e.g.: zh_CN, zh_TW and other language region codes

Configuration method:
1. Modify configuration in config.yml: language: language region code
2. Create language file in languages folder, name format: language region code.yml

Other versions configure in item.json
Configure according to json format, configured ones will be automatically translated, unconfigured ones won't, please strictly ensure each English word is correct (recommended to localize items as you use them, add here, then reload configuration file with command)

Example:
{
  "NAME_TAG": "Name Tag",
  "PAPER": "Paper"
}

3. Does it support mod items and custom items?

All custom items are supported
90% of mod items are supported, very few special items might not be supported
Recommend testing yourself

4. Using custom commands for task rewards

# Player executes command, 0 in the middle means execute as player identity, will fail if player has no permission
/plk addReward command 0 eco#give#${player}#666
# Player executes command, 1 in the middle means execute as op identity
/plk addReward command 1 eco#give#${player}#666
# Console executes command, 2 in the middle means console execution
/plk addReward command 2 eco#give#${player}#666

5. How to submit submit type tasks

Mouse middle button
Plugin version 1.12.2+ integrated into left mouse button function

6. NPC bound tasks click invalid

Please note PVP status
World PVP disabled or spawn protection etc. cannot trigger events
If PVP cannot be enabled, can use /plk openNpc [npcId] command to directly open (2.0.1+)

7. After refreshing tasks or players entering game, insufficient task count

Reason: Daily task count too low, I recommend setting each rarity's task count to more than 2 times the total daily tasks for reasonable results
Generally no need to handle, players re-entering game will automatically complete

8. Can task shop set purchase permissions?

Current version cannot

9. Can BC server using mysql connection have different versions for multiple sub-servers?

No, multiple versions with inconsistent item data will cause problems

10. After upgrading version, e.g. from 1.18 to 1.20, can I revert to 1.18?

No, can only upgrade, cannot downgrade versions

11. This plugin has high database requirements

sqlite has low capacity, servers with more than 20 online players recommend using mysql

12. What's the enchantment list for task objectives?

Click to view enchantment list (opens new window)

13. What are the permissions for rarity in task config.yml?

Format: 
playerTask.rarity.rarity type.permission type

Example: 
playerTask.rarity.normal.default (every player has default permission by default)
playerTask.rarity.normal.vip

14. What are the permissions for refresh count in task refresh.yml?

Format: 
playerTask.refreshNumber.permission type

Example: 
playerTask.refreshNumber.vip1
playerTask.refreshNumber.vip2

15. Players get the same tasks every time they log in

Reason: Daily task count too low, I recommend setting each rarity's task count to more than 2 times the total daily tasks for reasonable results

16. How to configure custom menu execution commands?

# Custom buttons you can infinitely expand the buttons you want here, format same as this example return
# 1. command: "plm open menu" normal player identity execute command (recommended)
# 2. command: "[op] plm open menu" OP identity execute command (not recommended)
# 3. command: "[console] plm open menu" console identity execute command (recommended)
# 4. command: "[close]" close current menu
# Note: ${player} represents player name
custom:
  # Back button
  back:
    enable: true
    index: 50
    name: "   &8[&aBack&8]"
    material: BARRIER
    isEnchant: false
    lore:
      - '&f- &7Click to return'
    custom-model-data: 0
    # Execute command
    command: "plm open menu"