Simply bear traps

Simply Bear Traps

Simply Bear Traps adds functional, animated, and customizable bear traps to Minecraft.

Place traps on the ground and use them to catch players and mobs. Once triggered, a trap snaps shut, deals damage, and temporarily prevents the trapped target from escaping.

The mod is designed to keep bear traps simple and useful for normal survival gameplay while also providing enough customization for dungeons, adventure maps, multiplayer servers, and modpacks.

Features Functional placeable bear traps Animated 3D models powered by GeckoLib Traps can catch both players and mobs Four different trap materials: Iron Gold Diamond Netherite Different damage, trapping duration, and reset speed depending on the material Trapped players can struggle to escape faster Struggling causes additional damage Other players can help release a trapped player Automatic trap rearming Dedicated trap tool for interacting with and recovering traps Traps retain their properties when recovered Dropped items can trigger traps Moving arrows can trigger traps Configurable player, mob, and boss trapping Dyeable traps with color mixing Entity Type tags for modpack compatibility Custom advancements Trap Materials

Bear traps are available in four materials:

Iron Bear Trap A standard, balanced bear trap.

Gold Bear Trap A faster trap with lower damage and a shorter trapping duration.

Diamond Bear Trap A stronger trap with increased damage and trapping duration.

Netherite Bear Trap The strongest version, designed for dangerous mobs and high-level gameplay.

The exact damage, trapping duration, and reset duration of every material can be changed through the configuration file.

Trap Dyeing

Bear traps can be dyed to help camouflage them with their surroundings.

Dye colors are applied to the entire trap model and are stored directly on the trap.

The selected color is preserved when:

The trap is placed The trap is recovered The trap is stored in an inventory The trap is dropped as an item

Colors can also be mixed, allowing a much wider range of colors than the standard Minecraft dye palette.

This makes it possible to camouflage traps in grass, caves, deserts, dungeons, and other environments.

Trapping and Escaping

When a player or mob activates a trap, the trap closes and deals damage to the target.

The trapped entity is temporarily prevented from simply walking away.

Players can struggle while trapped to escape faster. However, struggling causes additional damage, creating a risk/reward choice between waiting for release and attempting to escape early.

Other players can also help release a trapped player.

After releasing its target, a trap can automatically reset itself and become ready to trigger again.

These mechanics can be customized through the configuration file.

Configuration

Simply Bear Traps includes a configuration file intended for players, server owners, dungeon creators, and modpack developers.

Most important trap mechanics can be adjusted without modifying the mod itself.

General Settings

The following behavior can be configured:

Automatic Rearming Controls whether traps automatically rearm after releasing a target.

Automatic Rearming Delay Controls how long a trap waits before beginning the automatic reset process.

Trigger Cooldown Controls the grace period after a trap opens before it can activate again.

Struggle Escape Bonus Controls how much escape progress a trapped player gains when struggling.

Struggle Damage Controls how much damage a trapped player receives when struggling.

Release Slowness Duration Controls how long the Slowness effect lasts after escaping from a trap.

Release Slowness Level Controls the strength of the Slowness effect after release.

Player Triggering Controls whether players can activate bear traps.

Mob Triggering Controls whether non-player living entities can activate bear traps.

Boss Trapping Controls whether entities classified as bosses can be caught.

Item Triggering Controls whether dropped items can activate traps.

Arrow Triggering Controls whether moving arrows can activate traps.

Material Settings

Each trap material can be configured independently.

The following values can be changed for Iron, Gold, Diamond, and Netherite traps:

Damage Trap duration Reset duration

This allows modpack creators to rebalance the progression of all four trap tiers for survival worlds, PvP servers, hardcore modpacks, or custom dungeons.

Modpack & Dungeon Support

Simply Bear Traps is designed with modpack and dungeon compatibility in mind.

Entity Type tags are provided so entities from other mods can be classified without modifying Simply Bear Traps itself.

This is especially useful for bosses, NPCs, multipart entities, scripted entities, and other special mobs that may not behave correctly when immobilized.

Trap Immune Entities

The following Entity Type tag is available:

beartrapmod:trap_immune

Entities contained in this tag cannot be caught by bear traps, regardless of the normal mob or boss configuration.

Adding an Entity to trap_immune

A datapack can extend the tag by providing:

data/beartrapmod/tags/entity_types/trap_immune.json

Example:

{ "replace": false, "values": [ "examplemod:example_mob", { "id": "examplemod:example_boss", "required": false } ] }

"replace": false adds your entries without replacing entities already defined by Simply Bear Traps.

When referencing entities from optional mods, using "required": false is recommended. This prevents the tag from failing to load when the referenced mod is not installed.

Boss Entities

Simply Bear Traps also provides:

beartrapmod:bosses

Entities contained in this tag are treated as bosses by the trap system.

Whether these entities can actually be caught is controlled by the trapBosses configuration option.

Adding a Custom Boss

Create:

data/beartrapmod/tags/entity_types/bosses.json

Example:

{ "replace": false, "values": [ { "id": "examplemod:example_boss", "required": false } ] }

The entity will now be treated as a boss by Simply Bear Traps.

If boss trapping is disabled in the configuration, it cannot be caught.

If boss trapping is enabled, it can be caught unless it is also included in:

beartrapmod:trap_immune

Tag Priority

Entity trapping follows this priority:

beartrapmod:trap_immune → The entity can never be caught.

beartrapmod:bosses → The entity follows the trapBosses configuration.

Other living entities → They follow the normal player or mob configuration.

This allows modpack creators to add compatibility for entities from other mods through datapacks without requiring changes to Simply Bear Traps itself.

Advancements

Simply Bear Traps includes custom advancements related to using and interacting with bear traps.

Some advancements reward successfully catching prey, while others involve the more dangerous consequences of struggling inside a trap.

Requirements Minecraft: 1.20.1 Mod Loader: Forge Required Dependency: GeckoLib

Make sure the appropriate Minecraft 1.20.1 version of GeckoLib is installed.

Compatibility

Some modded entities use custom movement systems, multipart bodies, teleportation, boss phases, or other special mechanics and may not behave correctly when trapped.

If you encounter such an entity, it can be excluded from the trapping system by adding it to:

beartrapmod:trap_immune

This can be done through a datapack without modifying Simply Bear Traps itself.

Feedback & Bug Reports

This is the first release of Simply Bear Traps.

Bug reports, compatibility reports, balancing feedback, and feature suggestions are welcome.

When reporting an incompatibility with another mod, please include the name of the mod and the affected entity if possible.

Modpack usage is allowed. Feel free to include Simply Bear Traps in your modpack.