The biggest update so far. Every screen and the whole match HUD were rebuilt, matches now start the way players expect, and a lot of work went into making the mod lighter and impossible to get stuck in.

Requires Hytale Update 7. Back up your server before updating, as always.

Highlights

• Pickup games and ranked matches. Join a free arena and you are playing straight away. A ranked match is asked for, started by a referee or admin, or set to start on its own.
• A new HUD in the style of a TV broadcast: scoreboard, your card, an ability bar that names every action, play by play, animated goal banners and an end-of-match summary.
• New screens for everything. /sports for players, /sports admin for admins, plus new Arena, referee and Studio screens.
• Team mascots. Every team has a creature on its crest, and teams are named after them by default.
• Nothing of the mod follows you off the pitch. Leave an arena and your HUD, team and restrictions go with it.
• Better performance, with a lighter HUD and several memory leaks closed.

Before you update

• Command names changed. The command tree was reorganised and the old names were removed, with no aliases. If you have scripts, command blocks or other plugins that call nyoSports commands, update them using the table under Commands below. Typing an old name tells you the new one.
• Matches no longer start by people standing on the pitch. Players join from the trophy or with /sports play. Existing servers keep starting ranked matches automatically once both teams are full (now after a 10-second countdown); new installs start every match as a pickup game.
• Default team names change from Blue and Red to the mascots' names, unless you had written your own names, which are kept.

Added

Pickup games and ranked matches

• Joining a team on a free arena starts a pickup game at once, for any number of players. It has no winner on record and does not touch careers or rankings.
• Pickup goals and time played are still counted, on a separate pickup line per player and arena. A goal only counts while both teams have someone on them.
• A ranked match starts when a player with permission asks for it (/sports start, or the button on the Arena screen), when a referee or admin starts one, or automatically with the arena's auto-match setting. The pickup game carries on until both teams have enough players, then a 10-second countdown starts the ranked match with the same teams.
• After the final whistle, the arena goes back to a pickup game with the same teams.
• Each arena chooses who may ask for a ranked match: players with the new nyosports.match.host permission (default), anyone, or nobody but admins.

Joining and leaving

• Players join from the trophy (F) or with /sports play. Standing on the pitch puts nobody on a team.
• /sports play <arena> from elsewhere in the same world takes you to the arena and joins you.
• On net courts, joining puts you on your own half of the court.
• A first-time player gets a short welcome message, and walking up to an arena shows what is played there and how to join.
• Walking away from an arena takes you off your team after 5 seconds in a pickup game and 15 seconds in a ranked match, with a message explaining why. Changing worlds takes you off at once. Disconnecting does not.
• Anything the mod applied to a player (HUD, hidden game HUD, team name tag, ability buttons, movement, camera, items) is removed when they stop taking part in anything. A check runs every two seconds to clean up whatever is left over and reports it in /sports admin status.

The match HUD

• While you play, referee or watch on a camera, the game's own HUD is hidden and the match HUD takes over. Chat, the crosshair, notifications and the player list always stay.
• Scoreboard: crests, score, clock (counting down in timed matches, up in pickup games), pickup or ranked, and sets, games or legs where the sport has them.
• Player card: crest, name, team and a stamina ring, placed above the voice icons.
• Ability bar: every action you have right now, with its key, an icon and its name, a cooldown sweep, and a different look when an action is refused.
• Play by play in the top corner.
• Moment banners for goals (including "Header!"), baskets, threes, sets, games, legs and the final whistle, with the scorer and the new score.
• Phase cards for kickoff and half time, and an end-of-match summary for ranked matches with team comparison bars and the player of the match.
• Three HUD sizes per player: full, balanced and minimal (/sports settings hud, or Preferences).
• The first-time controls card now shows once per sport.

Team mascots

• Eight creatures for team crests: Kweebec, Trork, Feran, Outlander, Goblin, Skeleton, Scarak and Yeti. Each arena picks one per team (team1-emblem, team2-emblem). Defaults are Kweebec and Trork.
• The two crests always face each other.
• Team names follow the mascot by default (Kweebecs, Trorks…, with a three-letter short name), in the server's language. A name you write yourself is kept, and Use the mascot brings the default back.

Screens for players: /sports

• Play: where you are, every arena with its live score and free spots, and a button to join.
• Watch: live matches with a mini scoreboard.
• Profile: career numbers and charts (win rate, recent form, goals per match, ranked against pickup), a card per sport and your place at each arena.
• Controls: the mouse and keyboard drawn out, with every action of every sport and role.
• Preferences and a new Cameras section with an illustrated choice of camera for each role.

Screens for admins: /sports admin

• Overview: server health, live matches, players in arenas, a 14-day activity chart, and anything to fix, each with a button that fixes it.
• Arenas: every arena, a plan of its pitch, recent results and its problems.
• Configure: every arena setting, grouped and explained. Changes wait for Save.
• Arena area: redraw an arena from Configure. The selection tool is handed to you, the screen tells you what to do next, and you can Confirm the new shape or Cancel and get the old one back. There is also a button to go to the arena.
• Matches, Players (with a mini profile), Permissions (who can do what, with ready-made groups) and Server (database, world rules, cleanup, diagnostics and About).
• The Administration opens for anyone holding any admin permission, and shows only the sections they can use.
• In darts and archery, the player who placed a target can configure that one arena.

Referee and Studio

• The referee panel sits beside the pitch: the match, decisions, restarts and points, with cards drawn as cards. The new nyosports.referee.clock permission (everyone by default) lets a referee start, pause, resume and end the match without admin rights.
• An arena can allow anyone to referee, only an appointed referee, or nobody (referee setting).
• The Studio shows a plan of the pitch at the size you choose, and refuses arena names that are command words.

Volleyball, tennis and squash

• Serves are performed: the ball waits on the court, you walk to it, pick it up, toss it and strike, with new animations. The jump serve uses a real jump. Volley.ServeSequence, Tennis.ServeSequence and Squash.ServeSequence switch back to the previous serve.
• Volleyball has new animations for every contact, its own sound for each kind of touch, small particles, net and landing feedback, and a block reaction. All of it can be tuned or turned off.
• Squash has its own animations instead of borrowing tennis ones.
• Tennis strokes now follow through after contact.
• Ball trails are drawn by the game client as a smooth ribbon (Effects.Trail.Native).

Logs and language

• nyoSports keeps a daily log file in logs/ (seven days by default). The console stays short: what is on, and anything that needs your attention.
• Core.Language sets the language of the console and the log file.

Changed

• An ace is now an ordinary point: no goal-sized banner or fanfare.
• In volleyball, peteca, tennis and squash, an ordinary point is quieter: the point sound and a short crowd reaction, without fireworks, crown or camera shake. Sets, games and match wins keep the full celebration.
• Basketball baskets, squash points and archery ends use a medium banner. Sets, games, legs and full time use the big one.
• The call-for-ball marker lasts 1.2 seconds instead of 3.
• Spectator camera views are now named top, tv and ball.
• Many messages that still reached Portuguese players in English are now translated, and the console follows the server's language.
• Permission refusals no longer show the permission node to players.

Removed

• The old screens (trophy menu, profile, controls, sound, watch, arena admin page, referee page and Studio), replaced by the new ones.
• The old command names (see Commands).
• The nyosports.lang permission. Listing the installed languages is now /sports admin diagnose lang. A leftover grant or deny does nothing, and the server mentions it on start.
• Developer tools are no longer part of the released jar.

Fixed

• In a ranked match, stepping just past the stadium edge could cost a player their place on the first check. They now have 15 seconds.
• A referee who changed world kept the whistle. It is now returned, with a message.
• Changing world while on a pitch could leave the pitch's movement settings on the player.
• When the server was busy, loading a player's statistics could fail and drop a stat change, such as a goal scored right after joining.
• Several memory leaks: data kept for every player who ever joined, until the server restarted.
• An unnecessary allocation every tick for each player near a ball.
• Applying a setting on the old arena page ended the running match. Deleting an arena now also removes its statistics, as the command does.
• A darts or archery target owner could change settings without any permission check.
• The whistle and the referee screen picked the arena you were standing in instead of the arena of your whistle.
• Squash's stroke cooldown had no effect, so a player could hit the ball twice in a row. A jump serve's foot fault is now judged from where you left the ground.
• A console error when the server stopped, and a warning repeated many times a second about ball speed (now once a minute with a count).

Performance

• The match HUD costs about a quarter of what it did per player, and each player's screen refreshes on its own beat. With 22 players in an arena, the busiest tick went from about 1 ms to about 0.23 ms, and from 2 ms to 0.43 ms with 44 players. Goals, score changes and anything urgent still go out the moment they happen.
• With seven arenas loaded and nobody playing, the mod takes under 0.03 ms per tick.
• In a run of 280 matches back to back, memory stayed flat.

Commands

/sports and /nyosports are the same command.

New: /sports start [arena] [--cancel], /sports settings hud, /sports arena visit, /sports arena reshape --cancel, /sports admin status, /sports admin permissions, /sports admin diagnose ….

Commands that cannot be undone (deleting an arena, clearing it, ending or discarding a match) only run with the arena's name written out, and the reply shows the exact line to type.

Configuration

Your settings are kept. Each file is rebuilt with the new options, every value you changed is put back, and the old file is saved in backups/. A default you never touched moves to the new default.

Match.AutoAssignTeams, Stats.CountFreePlay, Volley.SoundAce, Peteca.SoundAce and the HUD Document and ZOrder keys are no longer used. They stay in old files without effect.

Permissions

• New nyosports.match.host: ask for a ranked match. Administrators by default.
• New nyosports.referee.clock: start, pause, resume and end a match as referee. Everyone by default.
• Removed nyosports.lang.

nyoSports 0.100.1

A follow-up to 0.100.0 focused on refereeing and the spectator cameras.

Refereeing

• Anyone allowed to referee can now referee on any arena. Most match modes had player referees switched off, so taking the role was refused on almost every arena, even for operators. Every mode now allows a referee by default. An arena still decides for itself with its referee setting: anyone, appointed or none.

• The whistle is gone. Taking the role, from the Arena screen or with /sports ref, gives you every referee action straight away. Whistles already in inventories are taken away quietly.

• Referee keys on the HUD:

  Key	Action
  Right click	Open the referee panel
  Q	Pause or resume the match
  E	Foul on the player you are looking at
  R	Card: tap for yellow, hold for red

  They are also listed in /sports › Controls › Referee.

• A cleaner referee panel: match state and clock controls first, then a card with your keys and Leave the role, then decisions, restarts and points.

• Several texts in the referee HUD and panel were missing a translation or showed a raw text key. They are all translated now.

• On an arena set to appointed, an admin can take the role themselves.

• Leaving the role (panel button, /sports leave, walking away, changing world or disconnecting) removes the referee keys with it.

Spectator cameras

• The way out is always on screen. In every camera, the HUD shows R · Leave camera, whatever else is happening and in every HUD size. If the key is not available, it shows the command instead.
• Reconnecting never puts you back in a camera. A player who leaves the server while watching comes back as a normal player. Their preferred cameras are kept.

Upgrading

• Match modes that had player referees off by default now have them on. A mode you had set on purpose to no referee may switch too, because it cannot be told apart from the old default; set referee none on the arena to keep it closed.
• The nyosports.referee.whistle permission keeps its name and now means taking the referee role.
• Runs on Hytale 0.7.4. Nothing the mod relies on changed in that update.