Description
# ๐ฅ Throwing Disc โ Minecraft Bedrock Addon
**Throw it. Watch it bounce. Catch it on the way back.**
Throwing Disc adds the brand-new returning ranged weapon to Minecraft Bedrock Edition, and nothing else. No extra mobs, no new blocks, no changes to your world. Just one very satisfying weapon in five tiers, built to feel like it belongs in vanilla.
---
## โจ What is the Throwing Disc?
The throwing disc is a boomerang-style weapon. You throw it in the direction you're looking, it spins through the air, slices through anything in its way, and then flies back to you. It doesn't travel far, but it makes up for that with tricks vanilla ranged weapons can't do:
- **It returns to you.** No picking it up off the ground, no retrieving it from a lava pit.
- **It ricochets.** Hard surfaces bounce it back into play, so walls, floors and ceilings become part of your aim. Every bounce also lets the disc fly a little farther.
- **It pierces.** One throw hits every mob lined up along its path, so standing in a row next to your friends is a bad idea.
- **It hits twice.** Enemies caught on the way out can be hit again on the way back.
---
## ๐งฐ The Five Tiers
| Tier | Damage | Durability | How to get it |
|---|---|---|---|
| Copper Throwing Disc | 2 hearts | 190 | Craft with 4 copper ingots |
| Iron Throwing Disc | 2.5 hearts | 250 | Craft with 4 iron ingots |
| Golden Throwing Disc | 2 hearts | 32 | Craft with 4 gold ingots |
| Diamond Throwing Disc | 3 hearts | 1561 | Craft with 4 diamonds |
| Netherite Throwing Disc | 3.5 hearts | 2031 | Upgrade a Diamond disc at a smithing table |
*Damage is per hit. Values are tuned for this addon and can be changed (see Configuration).*
### Recipes
**Copper, Iron, Golden and Diamond** use the same diamond-shaped pattern with four of the matching material:
```
[ ] [M] [ ]
[M] [ ] [M]
[ ] [M] [ ]
```
**Netherite** is made at a smithing table with a Diamond Throwing Disc, a Netherite Upgrade Smithing Template and a Netherite Ingot.
Each disc has its own hand-drawn icon and its own in-flight texture, so you can tell what's coming at you at a glance.
---
## ๐ฎ How to Play
1. Craft a disc (or grab one from the Creative inventory under **Equipment**).
2. Hold it and **right-click** (or tap to use on mobile and consoles).
3. The disc flies out in the direction you're facing.
4. It bounces off walls, pierces mobs and comes back to you.
5. Throw again once it's back in your hand.
**One disc can be in the air per hand.** You can't spam-throw the same disc, so timing and positioning matter.
### Pro tips
- **Bank shots:** stand beside a wall and angle your throw so the disc bounces back through a group of mobs.
- **Corridors are deadly:** a long hallway full of zombies is the perfect target for a piercing disc.
- **Mind the range:** a flat throw into open space won't go far. Use a nearby wall to extend it.
- **Watch your durability:** every throw costs 1 durability, and the disc breaks on its final throw. Repair it on an anvil with its matching material.
---
## ๐ง Features at a Glance
- โ
Five craftable tiers: Copper, Iron, Golden, Diamond, Netherite
- โ
Returns to the thrower after every throw
- โ
Ricochets off hard surfaces, up to 4 bounces per throw
- โ
Each bounce extends the flight distance
- โ
Pierces and damages every mob along the path
- โ
Hits on both the outward and return trip
- โ
Spinning in-flight model with a unique texture per tier
- โ
Throw sounds, ricochet sounds and catch sounds
- โ
Durability, anvil repair and a short use cooldown
- โ
Prepared for off-hand throwing (see Compatibility)
- โ
Works in Survival, Creative and Adventure
- โ
No Experiments or Beta APIs required
- โ
Lightweight: one item set, one projectile, one script
---
## ๐ฆ Installation
1. Download **ThrowingDisc.mcaddon**.
2. Open the file. Minecraft Bedrock will launch and import both packs automatically.
3. Create a new world, or edit an existing one.
4. Under **Behavior Packs** and **Resource Packs**, activate **Throwing Disc**.
5. Load the world. A chat message confirms the addon is running.
**Platforms:** Windows, Android, iOS and consoles that support add-ons. On consoles and mobile, import through the file browser or a Realms/server workflow.
### Getting a disc with commands
```
/give @s tdisc:copper_throwing_disc
/give @s tdisc:iron_throwing_disc
/give @s tdisc:golden_throwing_disc
/give @s tdisc:diamond_throwing_disc
/give @s tdisc:netherite_throwing_disc
```
---
## โ๏ธ Configuration
All the numbers live at the top of `scripts/main.js` in the behavior pack, so you can tune the disc to your server or map. Open the .mcaddon (it's a zip file), edit the values, and re-import.
| Setting | What it does |
|---|---|
| `speed` | How fast the disc flies out |
| `returnSpeed` | How fast it flies back |
| `baseRange` | How far it travels before turning around |
| `ricochetExtraRange` | Extra distance gained per bounce |
| `maxRicochets` | Maximum bounces per throw |
| `hitRadius` | How generous the hit detection is |
| `durabilityPerThrow` | Durability lost per throw |
| `TIERS[...].damage` | Damage dealt by each tier |
Recipes and durability can be edited in the item and recipe JSON files in the same pack.
---
## ๐ค Compatibility
- **Game version:** a recent Minecraft Bedrock release with the stable Script API 2.x (Minecraft 26.x / 1.26.x).
- **Other add-ons:** the pack adds only its own items and one projectile entity under the `tdisc:` namespace, so it won't conflict with other addons.
- **Multiplayer:** works on Realms, LAN and dedicated servers that allow scripting.
- **Off-hand:** the addon detects which hand holds the disc, so off-hand throwing will work as soon as your game version lets you use items from the off-hand.
- **Experiments:** none needed.
---
## โ FAQ
**Does it change anything else in the game?**
No. It only adds the throwing disc items and the flying disc entity.
**Why can't I throw a second disc right away?**
Each hand can only have one disc in the air. Wait for it to return.
**The disc broke, what happened?**
Every throw uses 1 durability, and a disc breaks on its last throw. Repair it on an anvil before it runs out.
**Can the disc hurt me?**
No. It flies through its thrower and never damages them.
**Does it go through walls on the way back?**
Yes. On the return trip the disc flies straight to you and ignores blocks, so it never gets stuck.
**Can I change the damage or the recipes?**
Yes. See Configuration.
**It isn't working!**
Make sure both the Behavior Pack and the Resource Pack are activated on your world, and that you're on a current Bedrock version. When the world loads you should see "[Throwing Disc] addon loaded" in chat.
---
## ๐ Notes
This is a fan-made addon inspired by the throwing disc announced for Minecraft's first game drop of 2027. It recreates the announced behavior: a returning, ricocheting, piercing ranged weapon in five material tiers. Damage values, durability and recipes are this addon's own tuning, so they may differ from the official release.
## โ๏ธ Credits & Legal
Minecraft is a trademark of Mojang Studios / Microsoft. This addon is not affiliated with, endorsed by or approved by Mojang or Microsoft.
