Learn how to upload custom throwables in t.i.ts step-by-step, fix errors, and mod safely with this beginner-friendly guide.
To upload custom throwables in T.I.T.S, create a properly structured item file (JSON/XML), place it in the mod folder, enable mods, and test it in-game to ensure it works correctly.
The first time I tried to upload a custom throwable in T.I.T.S, I genuinely thought I had everything figured out. The file looked clean. The code felt logical. I launched the game expecting magic.
Nothing happened.
No error. No crash. Just… silence.
That’s when it hit me, modding isn’t just about creating something. It’s about understanding how the game expects things to exist. And until you align with that invisible logic, your work stays invisible too.
So this guide isn’t just a checklist. It’s the path I wish someone had walked me through, confusion included.
Understanding What Custom Throwables Actually Are
Before you upload anything, you need to understand what you’re really building.
A custom throwable in T.I.T.S is:
- A consumable combat item
- Defined through structured data
- Triggered during battle with pre-set effects
At its core, it’s not “an object.”
It’s a set of instructions.
Think of it like a script disguised as an item. The game reads your file and asks:
- What is this item?
- What does it do?
- When should it activate?
According to modding best practices, items fail more often due to missing structure than incorrect logic.
That one idea alone saves hours.
Step-by-Step: How to Upload Custom Throwables in T.I.T.S
Step 1: Find or Create the Mod Folder
Start by locating the game’s mod directory.
Depending on your setup, this could be:
- A /mods folder
- A /data directory
- Or something similar inside the game files
If it doesn’t exist, create one.
This folder is your playground, but also your responsibility.
If it’s disorganized, your mod won’t load properly.
Step 2: Create Your Throwable File
Now comes the actual creation.
Most custom throwables are defined using JSON or XML. JSON is more beginner-friendly, so we’ll focus on that.
Example structure:
{
“id”: “pulse_grenade”,
“name”: “Pulse Grenade”,
“type”: “throwable”,
“damage”: 25,
“effect”: “stun”,
“description”: “A compact device that disrupts enemy systems.”
}
At first glance, it looks simple.
But here’s the catch, every character matters.
A missing comma or misplaced bracket can make the entire file unreadable.
One tiny syntax mistake can invalidate the entire throwable.
Step 3: Define Effects That Actually Work
This is where creativity meets mechanics.
Ask yourself:
- Should it deal instant damage?
- Should it apply status effects?
- Should it behave differently in certain conditions?
You can build:
- Fire-based throwables that deal damage over time
- Shock items that stun enemies
- Experimental throwables with hybrid effects
But here’s something I learned the hard way:
More features don’t make a better item.
Sometimes the simplest throwable, clear purpose, clean execution, is the most satisfying to use.
Step 4: Place the File in the Correct Directory
This step sounds trivial… until it breaks everything.
Your file must:
- Be inside the correct folder
- Follow naming conventions
- Avoid conflicts with existing IDs
Example structure:
/mods/custom_throwables/pulse_grenade.json
If the game can’t locate your file, it simply ignores it.
No warning. No hint. Just absence.
In T.I.T.S modding, file placement errors are one of the most common reasons items fail to load.
Step 5: Enable Mods and Test In-Game
Now launch the game and:
- Enable mod support (if required)
- Load a save file or start a test run
- Attempt to spawn or access your throwable
And here’s the honest truth:
It might not work on the first try.
That’s not failure, it’s feedback.
Testing is where you refine everything:
- Fix errors
- Adjust balance
- Improve functionality
Common Errors (And Why They Happen)
The “Invisible Item” Issue
Your throwable doesn’t show up at all.
Possible reasons:
- Incorrect folder path
- File not being read
- Duplicate or missing ID
This is the most frustrating error because it gives you nothing to work with.
Syntax Mistakes
Even experienced modders make these.
Common issues:
- Missing commas
- Incorrect brackets
- Wrong value types
Use a JSON validator if needed, it saves time.
Overpowered or Broken Effects
You finally get your throwable working… and suddenly every fight becomes trivial.
It’s tempting to create something powerful.
But power without balance kills gameplay.
Ask yourself:
- Is this still fun after the third use?
- Does it remove challenge entirely?
Designing Throwables That Feel Natural
Uploading a throwable is technical.
Designing one that feels right is something else entirely.
A well-designed throwable:
- Has a clear purpose
- Fits the game’s tone
- Adds meaningful choice
A poorly designed one:
- Feels random
- Breaks immersion
- Exists without reason
Think of it like cooking.
Anyone can throw ingredients together.
But making something people want again? That’s a different skill.
Comparison: Basic vs Advanced Throwables
| Feature | Basic Throwable | Advanced Throwable |
| Setup Complexity | Low | High |
| Effects | Single (damage) | Multiple (damage + status) |
| Error Risk | Low | High |
| Customization | Limited | Extensive |
| Gameplay Impact | Predictable | Dynamic |
If you’re just starting out, stick with basic throwables.
Advanced designs come later, naturally.
The Moment It Finally Works
There’s a strange moment when your throwable finally appears in-game.
It’s not dramatic. No fireworks.
Just a quiet realization:
“It worked.”
And then immediately:
“What else can I build?”
That curiosity is what keeps people modding.
Not the item itself.
The control behind it.
FAQ
How do I upload custom throwables in T.I.T.S without errors?
Ensure your file uses correct JSON/XML syntax, is placed in the proper mod folder, and mods are enabled in the game.
Do I need coding experience to create custom throwables?
No. Basic knowledge of structured data formats like JSON is enough to get started.
Why is my custom throwable not appearing in the game?
It’s usually due to incorrect file placement, syntax errors, or missing/duplicate item IDs.
Can custom throwables crash the game?
Yes. Incorrect formatting or broken scripts can cause crashes or prevent the game from loading properly.
Should I test on my main save file?
No. Always use a test save to avoid corrupting your main progress.
Key Takings
- Learning how to upload custom throwables in T.I.T.S starts with understanding structure
- Even small syntax errors can completely break your item
- File placement is just as important as the code itself
- Start simple before building complex throwable systems
- Testing is essential, not optional
- Balance matters more than power when designing throwables
- Mastering custom throwables opens the door to full game modding
Additional Resources:
- JSON Validator Tool: A simple tool to check your JSON formatting and catch errors before uploading your throwable files.






