Inventory

Inventory System

Welcome to the official inventory guide for Roots of the Wild! This page will walk you through everything you need to know to set up, test, and sync your character's inventory using the Tinglebot system. If this is your first time using the inventory system — don’t worry. We've made it simple, and this guide will take you step-by-step through the process.

What Is the Inventory System?

Every character in Roots of the Wild manages their inventory through a Google Sheet connected to our custom Discord bot, Tinglebot. This sheet tracks:

Weapons
Armor
Materials
Crafted goods
Loot, trades, and more

Once set up, Tinglebot helps validate and permanently lock in your character's items. This makes item use fair, traceable, and easy for mods to review during trades or events.

Key Commands

These commands are typed directly in Discord where Tinglebot is active. They help you set up, finalize, and check your character’s inventory.

PART 1: Setting Up Your Google Sheets Inventory

1️⃣ Open the Template
Use this official inventory template:
Inventory Template (Google Sheets)

Click File → Make a Copy
Rename your copy to something like Tingle’s Inventory

2️⃣ Create a Tab Named loggedInventory

At the bottom, click the + button to add a new tab
Name this tab exactly: loggedInventory (case-sensitive!)
Tip: You can also delete the word "Template" from the existing loggedInventory Template tab and clear all example data, preserving column headers.
Important: If this tab name is incorrect (e.g., Loggedinventory), the bot won’t work!

3️⃣ Add the Required Column Headers
In row 1 of the loggedInventory tab (cells A1 to M1), paste these headers exactly:

Do NOT add spaces, change capitalization, or rename any headers
Even small errors will cause the bot to fail

4️⃣ Add At Least One Item

Each row below headers = one item your character owns
For brand new characters, add starter gear (e.g., Well-Worn Trousers, Old Shirt, Starter Weapon)
Example row:
- Character Name: Tingle
- Item Name: Carrot
- Qty of Item: 5
Item names are case-sensitive and spelling-specific—typos will cause the bot to skip items. Using dropdown menus helps prevent mistakes.
For crafted items, fill the Obtain column with Crafting
For found, looted, bought, or gifted items, leave the Obtain column blank

5️⃣ Share Your Sheet with Tinglebot

Click the Share button (top right of your Google Sheet)
Under “Add people and groups,” paste this email:
tinglebot@rotw-tinglebot.iam.gserviceaccount.com
Set access to Editor
Click Send or Share
Note: Without this, Tinglebot cannot access your inventory

PART 2: Testing Your Inventory

Now that your sheet is ready, it’s time to test it!

How to Run the Test Command

In Discord (where Tinglebot is active), type /inventory test
Select your character name from the dropdown list
Press Enter

What the Bot Checks:

Is your Google Sheet link valid?
Is the loggedInventory tab named correctly?
Are all column headers exactly right?
Do you have at least one item listed?

If something’s off, the bot will tell you what to fix. Correct it, then run the test again.

If It Works:
The bot will reply:
✅ Inventory setup for [Your Character Name] is valid!
You’re ready to sync.

PART 3: Syncing Your Inventory (One-Time Only!)

After your inventory passes the test, you can finalize it.

How to Sync:

In Discord, type /inventory sync
Select your character name
Press Enter
Confirm the prompt by clicking ✅ Yes to lock in your inventory (or ❌ No to cancel)

Important:

Syncing is permanent and can only be done once per character
Once synced, your inventory is locked and saved on the bot forever

Common Problems & Solutions

❌ Problem: “Invalid link”

🔧 Fix: Make sure you're sharing a live Google Sheet (not a preview or private file).

❌ Problem: “Missing tab”

🔧 Fix: Double check your tab is named exactly loggedInventory — case and spelling must be exact.

❌ Problem: “Missing headers”

🔧 Fix: Make sure all 13 headers are present in Row 1 (A1–M1) and spelled exactly right.

❌ Problem: “Inventory already synced”

🔧 Fix: You can only sync once. After syncing, use /inventory view to check your inventory.

❌ Problem: Character name not found

🔧 Fix: Start typing the name slowly. It must match exactly, or your character might not be registered yet.

❌ Problem: Bot skipped some rows

🔧 Fix: Check for typos, blank rows, wrong formatting, or broken formulas. Ask a mod if you’re stuck!