Real Football⚽

⚽ Real-Football

Real-Football adds a complete football/soccer match system to Minecraft, built around custom gameplay, club management, referee tools, mobile controls, scoreboards, and pitch creation. It is designed for servers and players who want organized football matches directly inside Minecraft. 🏟️ Football Match System

Create and manage full football matches with:

Team 1 vs Team 2 setup
Friendly, League, and Cup match types
Match start / stop / resume controls
Period / half management
Overtime
Penalty shootouts
Final score screen
Saved match scoreboards

Matches can be controlled from an in-game OPTool interface instead of relying on many separate commands. ⚽ Custom Football Ball

Real-Football includes its own custom football ball entity.

Features include:

3D ball rendering
Ball physics
Shooting
Power shots
Low passes
High passes
Dribbling
Goal detection
Last-touch tracking
Automatic scorer detection
Automatic assist detection

The ball is not a dropped item or armor stand — it is its own football entity. 🧑‍⚖️ Referee Tools

Referees get a dedicated match panel with tools for controlling the game:

Add goal
Remove goal
Approve system-detected goal
Cancel system-detected goal
Give penalty
Give free kick
Give throw-in
Undo decision
Open VAR review
Hide final scoreboard
Stop match

The system can detect goals automatically, but the referee can still approve or cancel decisions if needed. 📊 Scoreboard & Match Results

Real-Football includes a custom scoreboard system:

Live match scoreboard
Goal animation overlay
Final result overlay
Scorers list
Assists list
Own goals marked as OG
Final scoreboard visible after match
Scoreboards saved to files
Old scoreboard files auto-cleaned after time

After the match, the final result can be saved and reviewed later. 🏟️ Pitch & Stadium Tools

Create football pitches directly in-game:

Mark full field/stadium region
Mark playable pitch region
Mark goal regions
Mark goal lines
Mark penalty spots
Generate pitch layout
Generate goals
Generate nets
Generate pitch lines
Generate flags and field details

The pitch system supports proper goal-line detection and playable-field boundaries. 🤖 Gemini API Pitch Generation

Real-Football supports pitch generation assisted by Gemini API.

The API can be used to analyze pitch size and generate a visual plan for:

Turf style
Line style
Goal style
Net style
Stadium layout

An API key is required before generation can be used. 🏆 Clubs & Teams

Real-Football includes a club system:

Players can request new clubs
Players must be free agents to create a club
Club requests require operator approval
Approved clubs can be selected as Team 1 or Team 2
Club owner / coach panels
Player contracts
Offers and transfers
Club budgets
Top money list

When a player creates a club request, they become the owner and player of that club, but approval is still required before official use. 👔 Coach Panel

Coaches and club owners can manage important match actions:

Choose free-kick taker
Choose throw-in taker
Add wall players
Set goalkeeper
Manage players
Handle match-related decisions from the coach panel

📱 Mobile Controls

Real-Football includes mobile-friendly controls for phone and tablet players.

Mobile support includes:

Manual device selection
Mobile GUI
Match-only football buttons
Shoot
Power shot
Low pass
High pass
Spin
Rainbow flick
Slide
Dribble
Goalkeeper buttons
Role panel shortcut
Stop match shortcut

Football action buttons only appear during active matches. 🧤 Goalkeeper Controls

Goalkeepers get special controls:

High left dive
High right dive
Low left dive
Low right dive
Catch / control ball

Goalkeeper actions are role-based. 📋 OPTool Interface

Most features are managed through the OPTool interface:

Admin tools
Player panel
Coach panel
Referee panel
Match setup
Terrain / pitch tools
Club tools
Ball settings
Mobile shortcuts
Scoreboard controls

The goal is to keep gameplay organized inside GUI menus instead of using many separate commands. 🎮 Controls

Default controls include:

Attack / left click: shoot
Attack + power modifier: power shot
PgDn: low pass
PgUp: high pass
N: spin
M: rainbow flick
G: slide
F5: open role panel
F6: stop match

Curve controls are currently disabled and may be reworked later. 🧾 Match Reports

Real-Football saves final scoreboard data including:

Final result
Match type
Scorers
Assists
Own goals

Saved scoreboards can be copied and stored elsewhere. ✅ Main Features

⚽ Custom football entity
🏟️ Pitch generation
🧑‍⚖️ Referee tools
🏆 Clubs and teams
👔 Coach controls
📱 Mobile controls
📊 Scoreboards
🎯 Goal detection
🅰️ Assist tracking
🥅 Own goals
🤖 Gemini API support
📋 OPTool GUI
🧤 Goalkeeper controls
💰 Club budgets
🔁 Transfers and offers
📝 Saved match results

Made by MontSnacek