Description
BetterEvE
Summary
A configurable faction warfare mod: vanilla and most modded mobs join teams, push lanes, and fight over crystal bases, driven by JSON scenarios.
Description
BetterEvE is a Minecraft Forge 1.20.1 faction warfare mod. It organizes vanilla mobs, most modded mobs, players, summons, and projectiles into configurable factions, then runs base-siege battles on JSON-defined maps.
Built for stream events, server minigames, custom PvP/PvE maps, and any scenario where you want mobs to fight for a faction.
Features
- Any number of factions — independent ID, name, and color; hostile/neutral relations with wildcard support; player factions persist across sessions.
- Vanilla and modded mobs — vanilla and most modded mobs select targets by faction hostility; each mob keeps its own attack behavior.
- JSON scenarios — factions, relations, lanes, crystals, phases, triggers, level tables, and keep-alive zones live in a scenario file editable outside the game.
- Crystal bases — configurable health, attack, armor, range, cooldown, and model scale; destruction events can drive announcements, cleanup, and phase changes through the scenario.
- Phases and triggers — timer, crystal destroyed, faction wiped, entity death, player death, health threshold, zone enter/leave, score, and command check, with
all_of/any_ofcombinations. - Lane pushing — waypoints define regions and routes define order; your faction walks forward, enemies walk in reverse, and combat takes priority over pathing.
- Summon and projectile inheritance — automatically inherits the summoner's faction and level with no per-mod configuration; existing factions are never overwritten.
- Level system — named level tables with exponential growth for health, attack, armor, and knockback.
- HUD — overhead health bars, faction versus bars, and a top scoreboard.
- Keep-alive zones — mobs inside do not despawn and chunks stay loaded; useful for fixed maps and stream scenarios.
- Sunburn toggle — off by default, configurable exceptions; only affects sunlight ignition.
- Vanilla boss access — the ender dragon's player-only damage limit is removed; the wither and warden can be damaged by non-players when their factions are hostile.
Requirements
| Item | Requirement |
|---|---|
| Minecraft | 1.20.1 |
| Forge | 47.x |
| Java | 17 |
| Side | Client + server |
Installation
- Install Minecraft 1.20.1 and Forge 47.x.
- Put
bettereve-<version>.jarintomods/. - Launch the game or server.
- Three presets ship with the repository:
default,red_blue_versus, andsimple_red_blue. On first load, presets are copied toconfig/bettereve/scenarios/. You can also place scenario JSON files there manually.
Quick Start
/bettereve scenario list
/bettereve scenario load default
/bettereve faction join red
Loading default enters the match_start phase and spawns 4 crystal bases. Mobs must be spawned manually with /bettereve spawn; they then push the lane. The default victory condition is destroying the enemy base.
Scenario Example
{
"id": "demo",
"name": "Minimal example",
"factions": [
{ "id": "red", "name": "Red", "color": "#FF0000" },
{ "id": "blue", "name": "Blue", "color": "#0000FF" }
],
"relations": [
{ "from": "red", "to": "blue", "type": "hostile" },
{ "from": "blue", "to": "red", "type": "hostile" }
],
"phases": [
{
"id": "start",
"commands": [ { "delay": 0, "command": "say Match started" } ],
"triggers": [ { "type": "timer", "threshold": 60, "targetPhase": "end" } ]
},
{
"id": "end",
"commands": [ { "delay": 0, "command": "say Match ended" } ]
}
]
}
Save it as config/bettereve/scenarios/demo.json, then:
/bettereve scenario load demo
/bettereve faction join red
Loading enters the start phase; after 60 seconds it advances to end.
Configuration
All configuration is driven by scenarios: one JSON file defines a complete game mode. No extra config file is needed.
- Presets:
scenarios/*.json - Runtime:
config/bettereve/scenarios/*.json
Common settings include factions, relations, waypoints, routes, crystal templates, phases, triggers, level tables, keep-alive zones, plus summon, projectile, boss, and rule options. See the repository README for the full field reference and examples.
Compatibility
- Minecraft 1.20.1
- Forge 47.x
- Client + server
Links
- Source and docs: https://github.com/SanZiNEO/BetterEvE
- Issues: https://github.com/SanZiNEO/BetterEvE/issues
License
LGPL-3.0. You may use, modify, and distribute it, including commercially; modified versions must be released under LGPL-3.0 with corresponding source.

