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 · rainbow 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.

📊 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.

📋 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.

🆕 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

✅ 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