editor uses by level - magemonkeystudio/divinity GitHub Wiki

🔁 Editor: Uses by Level

The Uses by Level option allows you to define how many times an item can be used depending on the player's level. This enables scaling usage limits as a character progresses.


⚙️ What the Editor Lets You Modify

  • Add new level thresholds
  • Set the number of uses allowed for players at that level

🧭 How It Works in the Editor

  1. Click “Add New Level” in the in-game editor.
  2. You’ll be prompted in chat to input the player level.
  3. After entering a level, you’ll be prompted to input the number of uses the item allows at that level.

You can repeat this to set different usage amounts for various level breakpoints.


📄 Example (Item Generator File)

uses-by-level:
  1: 3
  10: 5
  25: 10

In this example:

  • A level 1 player can use the item 3 times
  • A level 10 player can use it 5 times
  • A level 25 player can use it 10 times

🧪 Use Case

  • Limit powerful items to a few uses for low-level players
  • Encourage progression by scaling up item durability or power
  • Add lore-friendly limitations to magic scrolls, tools, or artifacts

Return to: Item Generator Module