Install one server edition
Use Java 25 and the 0.0.1 file for Paper 26.1.2 build 74, native CraftBukkit 26.1.2 or Spigot 26.1.2. Place one matching JAR in plugins/ and restart. The plugin uses persistent Bukkit item metadata and chunk/server save data. Java mod item IDs do not convert automatically.
Craft the equipment
The basic tool and food recipes are shared with the Java version. For Grasping I, combine one book, one string and one ender pearl. Combine matching books in an anvil to improve the level, then apply a book to a slingshot. This edition stores Grasping as item data.
- Emerald Apple ← Emerald, Emerald, Emerald / Emerald, Apple, Emerald / Emerald, Emerald, Emerald
- Fried Egg ← any item in #things:cookable_eggs in a furnace for 10 seconds
- Magnet ← Lapis Lazuli, empty, Redstone / Iron Ingot, Nether Star, Iron Ingot / empty, Iron Block, empty
- Obsidian Hammer ← Obsidian, Obsidian, Obsidian / Obsidian, Stick, Obsidian / empty, Stick, empty
- Quiver ← Leather, String, Leather / Leather, empty, Leather / Leather, Leather, Leather
- Slingshot ← Stick, String, Stick / empty, Leather, empty / empty, Stick, empty
- Torch Pouch ← Leather, String, Leather / Leather, empty, Leather / empty, Leather, empty
Carry light and ammunition
- The Torch Pouch stores four stacks of ordinary torches, up to 256. Double-right-click to open it. A single use on a supported face places one torch after the short double-click window. The empty and filled pouch use different sprites.
- The Quiver holds nine stacks, up to 576 ordinary stackable rounds. Use its selection row to choose ammunition. Sneak-use to cycle populated stacks. Slingshots consume flint; the Java mod also supplies arrows to bows and crossbows.
Load a slingshot or assemble arrows
Right-click a fletching table. For shot, place a core above the two modifier positions in the offset junction. On the arrow side place the tip, shaft and feather along the diagonal, or place an existing arrow at the bottom and modify it. Existing tipped or spectral arrows can retain their identity.
- For new arrows choose a stick, bamboo, blaze rod or breeze rod shaft. A stick is the baseline. Bamboo flies 1.1× as fast with 0.85× gravity; breeze rod flies 1.2× as fast with 0.65× gravity. A blaze rod adds fire. The three-part assembly produces eight arrows.
- Hold use on a slingshot for 20 ticks to load one flint. The following right-click fires with the elastic snap sound. Release before charging completes to keep the flint.
- Grasping I, II, III and IV return missed flint after 4, 3, 2 and 1 seconds respectively, within 16, 24, 32 and 48 blocks in the same dimension. Hits consume the shot; Creative firing does not generate extra flint.
Choose an ammunition core
The core sets the starting hit damage, speed multiplier and gravity multiplier. Larger gravity numbers make a shot drop faster.
- Amethyst — Amethyst Shard. Base damage 5, speed ×1, gravity ×1.
- Clay — Clay Ball. Base damage 3, speed ×1.1, gravity ×0.8.
- Copper — Copper Ingot. Base damage 4.5, speed ×1, gravity ×1.05.
- Diamond — Diamond. Base damage 6, speed ×1.1, gravity ×1.
- Flint — Flint. Base damage 4, speed ×1, gravity ×1.
- Gold — Gold Nugget. Base damage 4, speed ×0.85, gravity ×1.35.
- Iron — Iron Nugget. Base damage 5, speed ×0.95, gravity ×1.15.
- Netherite — Netherite Scrap. Base damage 7, speed ×0.9, gravity ×1.2.
- Obsidian — Obsidian. Base damage 6, speed ×0.8, gravity ×1.5.
- Prismarine — Prismarine Shard. Base damage 4.5, speed ×1.05, gravity ×0.9.
- Quartz — Quartz. Base damage 4.5, speed ×1.15, gravity ×0.85.
- Stone — Cobblestone, Cobbled Deepslate, Stone, Deepslate. Base damage 4, speed ×0.95, gravity ×1.1.
Fletching modifiers
Use these ingredients when preparing ammunition. Distinct abilities can be combined up to a maximum of three. Dyes add colored particle trails, and several dyes can cycle colors.
- Blinding — Ink Sac, Sculk, Sculk Vein.
- Burning — Blaze Powder, Magma Cream, Fire Charge, Magma Block.
- Freezing — Snowball, Ice, Packed Ice, Blue Ice, Snow Block.
- Glowing — Glowstone Dust, Glow Ink Sac, Glow Berries, Glowstone, Prismarine Crystals, Sea Lantern.
- Weighted — Iron Ingot, Iron Block, Copper Block.
- Bouncy — Slime Ball, Slime Block.
- Levitating — Shulker Shell, Chorus Fruit, Phantom Membrane.
- Poisonous — Spider Eye, Pufferfish, Poisonous Potato.
- Slowing — Honeycomb, Honey Bottle, Honey Block, Cobweb.
- Swift — Sugar, Rabbit Foot, Redstone.
- Weakening — Fermented Spider Eye, Rotten Flesh, Wither Rose.
- Knockback — Wind Charge, Gunpowder, Breeze Rod.
Food, brewing and the magnet
- Smelt an ordinary, brown or blue egg for 10 seconds to make a Fried Egg, restoring four food points and 2.4 saturation. The furnace awards 0.1 XP.
- Surround an apple with eight emeralds. An Emerald Apple restores six food points and 9.6 saturation. It grants Regeneration II for 10 seconds and Resistance I and Speed I for 30 seconds.
- An Enchanted Emerald Apple is rare loot in ancient cities, jungle temples and stronghold corridors or libraries. It restores ten food points, supplies 30 saturation before the hunger cap, and grants Regeneration IV for 20 seconds, Strength II for 60 seconds, Resistance III, Speed II and Absorption V for two minutes, and Fire Resistance for eight minutes.
- Use a shulker shell with an Awkward Potion in a fueled brewing stand for three minutes of Levitation I. The Java recipe supports drinkable, splash and lingering awkward inputs, preserving the bottle kind. The mod also registers the corresponding tipped-arrow effect.
- Hold the Magnet in a hand to pull nearby dropped items toward you from within three blocks. The Obsidian Hammer mines a 3×3 plane perpendicular to the face hit and has 1,250 durability.
Play on an ordinary client
- Fletching, the four torch slots and the nine quiver stacks open in vanilla inventory screens. Decorative slots mark the limits. Double-right-click the pouch in hand or inventory to open it. Shift-right-click the quiver in inventory to open its menu.
- The plugin animates slingshots using the vanilla bow pose. The optional pack supplies four frame textures. The hammer shows cracks on affected blocks; the vanilla selection outline surrounds the targeted block.
- The plugin rolls a 1.5% chance for an enchanted emerald apple in each of the four eligible vanilla chest tables. Loaded ammunition and portable storage persist on items. On logout or shutdown, pending missed shots are dropped normally.
Server controls and permission nodes
- /usefulstuff give <item> [player] gives an identified item. The IDs are obsidian_hammer, magnet, slingshot, quiver, torch_pouch, fried_egg, emerald_apple, enchanted_emerald_apple, grasping_1 through grasping_4, levitation_potion, levitation_splash, levitation_lingering and levitation_arrow.
- /usefulstuff check runs item, recipe, storage and modifier diagnostics. The give and check commands use usefulstuff.admin, granted to operators by default.
- /usefulstuff pack offers the configured client pack. usefulstuff.pack defaults to true.
Offer the pack from a server
Host the unmodified 26.1.2 ZIP over HTTPS. In plugins/UsefulStuff/config.yml, set resource-pack-url to that URL and resource-pack-sha1 to 384ba8a6e45b029ec662fd046ca0e7f76492f589 for version 0.0.1.
- offer-pack-on-join defaults to true, require-resource-pack defaults to false, and the default URL is blank. Players with usefulstuff.pack can request it later using /usefulstuff pack.
- Players installing it manually place the ZIP in resourcepacks/ and enable it in Minecraft's Resource Packs screen. Leave the ZIP intact.
