Village Upgrades
Village Upgrades
Survival takes co-operation, and villages need fortification.
The Village System allows players to upgrade their home villages, but it also allows for villages to become damaged due to monster attacks, natural disasters, and poor weather.
Each village has three levels, and upgrading them provides benefits for all residents of that village.
Benefits include:
Lowered risk of random Raids
Rest Spots unique to each village
New and rarer items found on gathering tables
Better shop stock
But be warned… Villages must also be maintained. Failure to take care of what is built can cause a village to be downgraded, rendering higher level benefits inaccessible, and donated items will disappear.
Village Upgrades encourage community co-operation and progression. Donate over time when you can, and reap the rewards for you and your community.
Key Commands
The following Commands are the primary tools you will use to complete Village Upgrades. Please use these commands in their respective townhalls for your desired outcome! If you are donating to Rudania for example, please use the command /village donate in #rudania-townhall!
Village Status
Villages can have three statuses:
Upgradeable, Damaged, and Max.
Upgradeable
An upgradeable village can receive donations to increase the progress bar to a higher level.
If all requirements are met, the village levels up automatically. In this state, both Items and Tokens may be donated.
Damaged
A damaged village is a village that requires Tokens for repairs. A village can become damaged due to monster attacks, poor weather, and natural disasters.
When a village is Damaged, it cannot receive upgrades. It must be repaired first.
Max
This village has been fully upgraded and requires no further attention at the present time.
/village upgrade
Required Fields
charactername: Your character (select from list)name: Your HOME village (must match character home village)type: Items or Tokensqty: Amount to donate
Optional Fields
itemname: Required only when type: Items (select from list)
The bot checks these in order:
Step 1: Character check
Character exists
Character belongs to you
Step 2: Village match check
Must be your character’s HOME village
Step 3: Weekly cooldown check
Only 1 donation per week per user total across all villages
Resets Sunday at midnight EST
Step 4: Resource check
Items: must have enough in inventory
Tokens: must have enough in balance
Step 5: Donation limit check
Items: max 10% of required per donation
Tokens: max 5% of required per donation
Step 6: Village status check
If village is damaged:
Items are blocked
Tokens repair first, then upgrade
Step 7: Deduction + update
Items removed OR tokens deducted
Village progress updated
Contributor tracking updated
Progress bars shown
Final: Level-up check
If all required materials and tokens are met, the village levels up automatically
Bot announces the level up
Materials are cumulative. Donations carry forward between levels.
Tokens reset on level up. Materials persist, tokens go back to 0.
/village view
Required Fields
name: Select a village (Rudania, Inariko, or Vhintl)
Optional Fields
None
The bot checks these in order:
Step 1: Bot loads the selected village
Step 2: Bot displays:
Village level
Current HP bar
Shop status
Token and material progress bars
Top 3 contributors
Final: No restrictions, anyone can use it
/village contributors
Required Fields
name: Select a village
Optional Fields
None listed
Contributor tracking is by character, not user.
/village rest
Required Fields
charactername: Your charactername: Select the village you are resting in
Optional Fields
None listed
The bot checks these in order:
Step 1: Character check
Character exists
Character is not KO’d
Step 2: Location checks
Must be physically located in that village
Must be used in the village town hall channel
Step 3: Village level check
Must be Level 2+
Step 4: Health check
If already full hearts and stamina, it can be blocked
Step 5: Daily cooldown check
Resets 8am EST
Step 6: Apply restoration
Level 2: restores 1 or 2 hearts (50/50)
Level 3: player chooses button, then 50% success chance
Final: Cooldown is consumed even if Level 3 fails
You still used it, yeah.
Rest spot themes exist:
Rudania: Hot Springs (🔥)
Inariko: Cleansing Pool (💧)
Vhintl: Sacred Grove (🍃)
✅ When This Mechanic Is Required
You MUST use this mechanic when:
You want to help upgrade your village
You have items or tokens to donate
Your village needs materials or tokens for the next level
Village HP is below maximum and it needs repair
You need to repair before donating materials
You want to restore hearts or stamina
Your character is low on hearts or stamina and the village is Level 2+
You are in the village town hall channel and want to use the rest spot
You want to check village progress
See what materials are needed
Check how much has been donated
See top contributors
🚧 What Will Block This Mechanic
Common blockers the bot will enforce:
❌ Weekly donation cooldown
❌ Wrong home village
❌ Village needs repair (blocks material donations)
❌ Max level reached (Level 3 and fully repaired)
❌ Insufficient tokens or items
❌ Donation limit exceeded (10% items, 5% tokens)
❌ Invalid item name (item not needed)
❌ Rest spot used in wrong channel
❌ Rest spot used in wrong location
❌ Rest spot used when village is below Level 2
❌ Rest spot already used today
❌ Character KO’d (rest spot blocked)
🛠 The bot will always explain the failure reason.
🐾 Possible Outcomes
Common Outcomes
✅ Successful item donation
Items removed, progress increases, contributors update.
✅ Successful token donation
Tokens deducted, progress increases, contributors update.
✅ Village repair (via token donation)
Tokens repair HP first, leftover tokens go to upgrading.
✅ Rest spot success (Level 2)
1 or 2 hearts restored.
✅ Rest spot success (Level 3)
If the 50% roll succeeds, you receive the chosen effect.
Rare or Special Outcomes
🌟 Village level up
Happens automatically when all requirements are met.
⚠️ Village level drop
If village HP reaches 0 from monster damage:
Village level decreases (3→2 or 2→1)
All resources reset (materials and tokens reset to 0)
HP resets to max for the new level
❌ Rest spot failure (Level 3 only) If the 50% chance fails, nothing is restored and cooldown still applies.
🎯 What Happens After Completion
🧯 Common Problems & Fixes
❌ Problem: “⏳ You’ve already contributed to a village this week.”
💡 Solution: Wait for reset at Sunday midnight EST.
❌ Problem: “❌ Cannot Donate to This Village…”
💡 Solution: You can only donate to your character’s home village. Check with /character view.
❌ Problem: “❌ This village needs to be repaired before materials can be contributed.”
💡 Solution: Donate tokens first. Tokens repair HP automatically before upgrading.
❌ Problem: “❌ Maximum Donation Exceeded…”
💡 Solution: Lower the donation amount to within the cap:
Items: 10% of required
Tokens: 5% of required
❌ Problem: “❌ Invalid item name.”
💡 Solution: Use /village view and select item names from the autocomplete list.
❌ Problem: “❌ This command can only be used in [channel].”
💡 Solution: Use /village rest in your village’s town hall channel.
❌ Problem: “❌ You must be physically located in [Village].”
💡 Solution: Use /travel to reach the village first.
❌ Problem: “❌ No restoration occurred (50% chance failed).”
💡 Solution: That is expected at Level 3. Try again tomorrow after the reset.