Real Football⚽

⚽ Real football matches inside Minecraft — a real ball, real clubs, a real referee.

Kick off a match, run a club, let the ref make the call. Everything lives in one in-game menu, so nobody has to memorise commands.

🟢 Server-side only. Install it on the server and you're done. Players join with a plain vanilla client — no modpack, no resource pack, nothing to download. Phone players get a touch GUI, PC players get keybinds.

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

⚡ START A MATCH IN 3 STEPS

1️⃣ Drop the jar for your Minecraft version and loader into mods/, then start the server.

2️⃣ Type /optool — one menu holds every tool in the mod.

3️⃣ Mark a pitch ➜ generate it ➜ pick Team 1 vs Team 2 ➜ kick off.

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

⚽ A REAL BALL — NOT AN ITEM

The football is its own entity with a 3D model and proper physics. Not a dropped item. Not an armor stand.

🥅 Shoot · power shot · low pass · high pass

🌀 Skills — dribble · spin · ✨ flick · slide

🎯 Smart tracking — goal detection, last touch, automatic scorer and assist credit

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

🏟️ MATCHES WITH REAL STRUCTURE

🏅 Three formats: Friendly, League and Cup

⏱️ Start, stop and resume · halves and periods · overtime

🥅 Penalty shootouts when it stays level

📋 Final score screen, saved scoreboard and a full match report

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

🧑‍⚖️ THE REFEREE HAS THE FINAL WORD

Goals are detected automatically — the ref can still approve them, wave them off or send the moment to VAR.

👉 Open the referee panel

⚽ Goals — add goal · remove goal · approve detected goal · cancel detected goal
🚩 Restarts — penalty · free kick · throw-in
🎬 Review — open VAR review · undo last decision
🛑 Match — hide final scoreboard · stop match

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

📊 SCOREBOARDS THAT TELL THE STORY

📺 Live score during play, with a goal animation overlay

🏆 Final overlay with scorers, assists and own goals marked OG

💾 Every scoreboard is saved to a file — old ones clean themselves up

📝 Match reports keep the result, the format, the scorers and the assists

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

🏗️ BUILD THE STADIUM IN-GAME

📐 Mark the stadium region, the playable pitch, goal regions, goal lines and penalty spots — the engine uses them for goal-line and out-of-play detection.

✨ Generate the pitch layout, goals, nets, lines, flags and field details in one click.

🤖 Optional: Gemini-assisted design. Let the Gemini API read your pitch size and propose turf, line, goal and net styles plus a full stadium layout. Needs your own API key — everything else works without it.

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

🏆 CLUBS, CONTRACTS AND MONEY

A club is more than a name — it's a squad, a budget and a transfer market.

📝 A free agent requests a club, an operator approves it, and the founder becomes owner and player

⚔️ Approved clubs can line up as Team 1 or Team 2

💰 Contracts · offers · transfers · club budgets · server-wide top money list

👔 Coach panel — choose the free-kick taker, pick the throw-in taker, build the wall, set the goalkeeper and manage the squad live, mid-match

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

📱 PLAYS GREAT ON PHONES

Touch controls appear only while a match is running, so the screen stays clean the rest of the time. Keeper buttons swap in automatically for the player in goal.

👉 Open the mobile button set

⚽ Attacking — shoot · power shot · low pass · high pass
🌀 Skills — spin · ✨ flick · slide · dribble
🧤 Goalkeeper — high dive left/right · low dive left/right · catch and control
⚙️ Shortcuts — role panel · stop match

👉 Open the keyboard controls

🖱️ Shoot — attack / left click
💥 Power shot — attack + power modifier
⬇️ Low pass — Page Down
⬆️ High pass — Page Up
🌀 Spin — N
✨ ✨ flick — M
🦵 Slide — G
🎽 Role panel — F5
🛑 Stop match — F6

Curve controls are disabled for now and may return reworked.

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

📋 ONE MENU, NOT FIFTY COMMANDS

/optool is the whole mod: admin tools · player panel · coach panel · referee panel · match setup · pitch tools · club tools · ball settings · mobile shortcuts · scoreboard controls.

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

📦 WHERE IT RUNS

🧵 Fabric & Quilt — every version from 1.20 to 26.2

🔶 NeoForge — 1.20.1 to 26.2 (NeoForge simply doesn't exist for 1.20)

🔩 Forge — 1.20 to 26.2, except 1.21.2 and 1.20.5 (Forge never shipped those two)

📥 Fabric and Quilt builds need Fabric API (QFAPI/QSL on Quilt). NeoForge and Forge need nothing extra.

👉 See the full version list

26.2 · 26.1.2 · 26.1.1 · 26.1
1.21.11 · 1.21.10 · 1.21.9 · 1.21.8 · 1.21.7 · 1.21.6
1.21.5 · 1.21.4 · 1.21.3 · 1.21.2 · 1.21.1 · 1.21
1.20.6 · 1.20.5 · 1.20.4 · 1.20.3 · 1.20.2 · 1.20.1 · 1.20

Pick the file that matches your Minecraft version and your loader — every combination that exists is published.

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

🆕 WHAT'S NEW — v0.2a

🔄 Every build rebuilt from the current codebase, so Fabric, Quilt, NeoForge and Forge behave identically on all 23 Minecraft versions

🧾 Corrected metadata in every jar — right loader dependency, right Minecraft range, marked server-side, so launchers stop warning about it

🧩 Same coverage as v0.1a: four loaders, 1.20 through 26.2

👉 Older releases

v0.1a — first public release: full match system, custom football entity, referee tools with VAR, clubs, contracts and transfers, pitch and stadium generation, live scoreboards and match reports, mobile and goalkeeper controls, and the OPTool GUI. Published for Fabric, Quilt, NeoForge and Forge across 1.20 to 26.2.

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

✅ EVERYTHING IN ONE LINE

⚽ Custom ball entity · 🏟️ pitch generation · 🧑‍⚖️ referee tools · 🎬 VAR · 🏆 clubs and transfers · 👔 coach panel · 📱 mobile controls · 🧤 goalkeeper dives · 📊 live scoreboards · 🎯 goal detection · 🅰️ assists · 🥅 own goals · 💰 club budgets · 🤖 Gemini API · 📋 OPTool GUI · 📝 match reports

⚽ Made by MontSnacek — Real-Football v0.2a