Bettersurvival_tweak

Create custom BetterSurvival weapons with custom effect/stats/model/texture via JSON config + 50+ FREE weapon textures & models included!
# BSTweaker - Custom BetterSurvival Weapons

**Version: 1.0.1** | For BetterSurvival

> This is my first uploaded mod! If you encounter any bugs, please report them on the [Issues page](https://github.com/CFP106020087/BSTweaker/issues).

An addon for [BetterSurvival](https://www.curseforge.com/minecraft/mc-mods/bettersurvival) that lets you create custom weapons through JSON config files.

---

## 50+ Free Art Resources Included

| Material | Weapons | Animated |
|----------|---------|----------|
| Fire Dragonsteel | 6 | Yes |
| Ice Dragonsteel | 6 | Yes |
| Lightning Dragonsteel | 6 | Yes |
| Emerald | 6 | Yes |
| Obsidian | 6 | Yes |
| Scarlite | 6 | Yes |
| Umbrium | 6 | Yes |
| Special Weapons | 8 | Partial |

**53 models + 51 textures  - all CC0 Public Domain.

---

## Features

### Custom Weapons via JSON
Create Nunchaku, Hammer, Dagger, Battleaxe, or Spear with custom stats/texture/model/special scripted effects/tips by editing `weapons.json` in simply configuration file.

### Hot-Reload
`/bstweaker reload` - apply changes without restarting.

### Scripted Weapon Effects
Add special abilities using Script. Example:

```json
{
  "id": "vampiric_dagger",
  "events": [{
    "event": "onKill",
    "actions": ["self.heal(2)"]
  }]
}
```

Available APIs: `self.heal()`, `victim.setFire()`, `event.setAmount()`, `victim.addPotionEffect()`, etc.  

### Custom Tooltips
Add tip text to any BetterSurvival weapon.

---

## Known Issues

**Models not loading on first launch?**  
Press **F3+T** to reload resources.

---

## Requirements

- Minecraft 1.12.2
- Forge 
- BetterSurvival (required)
- FermiumBooter (for Mixin support)

## License

Public Domain (CC0) - Free for any legal use.

The Bettersurvival_tweak Team

profile avatar
jason672
Owner
  • 5
    Followers
  • 3
    Projects
  • 2.3K
    Downloads

More from jason672

  • enigmatic-addons-legacy project image

    enigmatic-addons-legacy

    Bymuxi114514
    • 2.4K
    • Mods

    Addons for enigmaticlegacy-legacy

    • 2.4K
    • April 11, 2026
    • Mods
    • +4
    View
    Install
  • BaubleVault project image

    BaubleVault

    Byjason672
    • 1.4K
    • Mods

    "BaubleVault extends Baubles with configurable extra slots, unlock-based progression (multiple listener), armor-to-bauble conversion with nature ability (yes include special event driven ability) and overlay inherited, and swappable icon themes."

    • 1.4K
    • February 21, 2026
    • Mods
    View
    Install
  • cross-dim/infinite range RS boost card project image

    cross-dim/infinite range RS boost card

    Byjason672
    • 608
    • Mods

    Adds Infinity Card and Dimension Card upgrades for Refined Storage's Wireless Transmitter — unlimited range, cross-dimension access, and automatic chunk loading.

    • 608
    • February 19, 2026
    • Mods
    • +1
    View
    Install
  • enigmatic-addons-legacy project image

    enigmatic-addons-legacy

    Bymuxi114514
    • 2.4K
    • Mods

    Addons for enigmaticlegacy-legacy

    • 2.4K
    • April 11, 2026
    • Mods
    • +4
    View
    Install
  • BaubleVault project image

    BaubleVault

    Byjason672
    • 1.4K
    • Mods

    "BaubleVault extends Baubles with configurable extra slots, unlock-based progression (multiple listener), armor-to-bauble conversion with nature ability (yes include special event driven ability) and overlay inherited, and swappable icon themes."

    • 1.4K
    • February 21, 2026
    • Mods
    View
    Install
  • cross-dim/infinite range RS boost card project image

    cross-dim/infinite range RS boost card

    Byjason672
    • 608
    • Mods

    Adds Infinity Card and Dimension Card upgrades for Refined Storage's Wireless Transmitter — unlimited range, cross-dimension access, and automatic chunk loading.

    • 608
    • February 19, 2026
    • Mods
    • +1
    View
    Install