EARLY ACCESS - nyoSports | ⚽Soccer, Basketball, Volleyball, Tennis

The mod is in Early Access, bugs may occur, so always back up your server before installing the mod.

The mod is designed for servers, so you cannot play without an admin to create the arena, and you cannot craft the mod’s items, you’ll need to obtain them in Creative mode.

Eight sports your players can actually play. Walk onto a pitch with somebody and a match starts on its own — sides, a clock, a scoreboard, restarts, and a final whistle with a winner.

Football is the full game: possession, charged shots, slide tackles, headers, throw-ins, corners, goal kicks, penalties, offside, fouls and cards. Seven more sports run on the same engine, from a volleyball court to a dartboard on a wall.

You build the ground, and nyoSports fits itself to what you built. Everything is set up from screens inside the game — pick a sport, drag the pitch into place, press build. Almost nothing has to be typed.

The sports

Complete is the flagship, and everything else is built on it. Beta is fully playable and still being tuned. Alpha is playable, with rougher edges and more change ahead.

They all share one match loop, one scoreboard, one statistics layer and one permission tree, so a court on a server that already runs football costs nothing extra to add. Several matches on several grounds run in the same world at the same time.

Building a ground

Take out the planner (/nyosports give planner), right click where you want the ground to sit, then left click to open the studio.

Five steps across the top:

Nothing is written until that last button. Until then you are moving a live preview around, and the figure strip at the top tells you what the build will actually place before it places it.

Already built a stadium? Drag the box to fit it and turn the ground step off. The pitch is what you built, to the block — the lines, the goals and the stands stay exactly where you put them.

Nothing is frozen afterwards. Plant a corner flag at the ground and touching it opens that arena's own screen: size, markings, match rules, teams, presentation, all of it, one value at a time. Change a number, press Rebuild, and the world catches up.

Everything is a screen

The point of the mod is that a server owner never needs the guide open in another window, and a player never needs to be told a command.

There are screens for your own career record, for the broadcast cameras, and for your own audio levels too.

Playing

Two mouse buttons carry every verb, and what they do is read from your situation rather than from a mode you selected.

• Football — hold left click to charge a shot and release; longer hold, harder shot. Right click lofts it. Walk into a ball and it moves. Jump to head it. Crouch-slide to tackle.
• Volleyball and peteca — left sends it over the net, right keeps it on your side. Where you are and where the ball is decides whether that is a receive, a set, a spike, a tip or a block.
• Basketball — left passes, right puts it up. Set shot, layup, jump shot or dunk depending on where you are and whether your feet have left the ground.
• Tennis and squash — hold the button before the ball arrives and it strikes the moment the ball is in reach. Left hits through it, right hits under it.
• Darts and archery — hold to steady your arm, release inside the window.

Three ability keys sit on top of the mouse, and what they do changes with what you are doing: the three you get with the ball at your feet are not the three you get without it, and a goalkeeper gets three of their own inside the area.

Nobody has to memorise any of that. A key strip in the corner of the screen always shows the three keys you have right now — a picture of what each one does, the word for it, and its cooldown — and it draws the key you actually have bound.

On screen

• A scoreboard and a match clock.
• A per-sport instrument band: the shot clock, the touch counter, the service box, the darts turn strip, the archery end totals.
• Your own card, with figures nobody else sees — goals, assists, shots and tackles for an outfield player; saves, goals conceded and touches for a goalkeeper; fouls given and cards shown for a referee.

Every element can be moved or removed, and your hotbar and health bar stay where they are.

The match

It runs itself: warm-up, kickoff, play, goals, half time, ends swap, full time, a winner.

• Real restarts. Throw-in, corner, goal kick, free kick, penalty, drop ball — each placed properly and announced with the reason it was given.
• Rules you choose, one at a time. Offside is judged at the moment the pass is played. Fouls are judged on contact — a clean slide that gets the ball is never one. Yellow and red cards mean what you expect. Turn any of it off and it is simply not part of the game.
• A human can referee. Hand somebody the whistle and they get the kit, the screen and three ability keys for the whistle.
• Match presets are files you can edit. Every sport ships four to six — kickabout, competitive, tournament and so on — and one you write yourself is never overwritten.
• Teams sort themselves out. Stand in the end you want to defend during warm-up. Leave and come back and you are on the same side.

Around the match

Statistics and careers

Goals, assists, saves, tackles, points, minutes played and match history — kept per player, per ground and per sport. Players read their own record on a screen; a ground's public board is one touch away on the trophy.

It works out of the box with no setup, keeping everything in files. If you run a network, point it at MySQL, MariaDB, PostgreSQL or SQLite instead: give every server the same table prefix and a player's career follows them across all of them, and a website can read the same rows the mod writes. The driver is fetched and verified on first use — there is nothing to install.

Permissions

43 permission nodes, one per thing you might want to hand to one person and not another.

• Player-facing things are open by default — playing, watching, the trophy screen, the stats board, choosing a language, and officiating if you hand somebody the whistle.
• Everything administrative is closed by default — shaping a ground, running a match.
• An operator needs no configuration at all.

/perm group Builders add nyosports.arena.*        the whole arena subtree, no match control
/perm group Referees add nyosports.referee.*
/perm group Referees add -nyosports.referee.card  and take one thing back out of it

Configuration

Every tuning value in the mod is in a file, and nothing is hardcoded. Nineteen of them, split into a folder per sport, plus one each for the server, the match loop and presentation.

• Each section explains itself where you find it. Every block opens with a comment saying what it is for and what the keys that need explaining do — and those are rewritten each boot, so a file never documents a version you are not running.
• Your edits survive updates. Files are upgraded individually and a value you changed is kept. Backups go in a backups/ folder next to the original.
• What you edit and what the mod writes are separate folders. Copy your settings to another server without dragging a season of records along with them.

nyoSports reports anonymous usage counts to bStats and HStats — never names, worlds, scores or anything you typed. One key in the config turns it off entirely.

Performance

An empty server with nyoSports installed costs 0.002 ms per tick. Four full 11-a-side matches running at once cost 0.051 ms per tick, with the server holding a flat 30 TPS. Nothing is allocated per tick while a match is running, and a server with no grounds on it pays nothing at all.

Commands

You can run the whole mod from the screens. These are the ones worth knowing anyway:

Everything else — arenas, matches, rules, the referee, voice, statistics, the database — has a subcommand too, and /nyosports on its own will point you at it.

Languages

English and Portuguese, and each player sees the mod in their own language with nothing to set.

Adding another is copying one file and translating the right-hand side of it. On a server running from a folder the change applies immediately, with no restart.

What is coming

Being worked on now: volleyball, basketball and peteca toward a full release, and tennis, squash, darts and archery through beta.

Planned: bowling, baseball, table tennis and American football.