Skip to content

v0.3.0-beta.1 (closed beta)

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 05 Nov 23:09
a11b06f

✨ New

  • Format Document for handlers. Shift+Alt+F re-indents and spaces a handler. It never moves a line (Nucleus runs handlers line by line) and checks that every token and comment is unchanged, so the handler does exactly the same. Also nucleus format (--write, --check) and the MCP tool nucleus_format.
  • A changed Game.GUID before it reaches players. For a handler with a Hub.Handler.Id line, VS Code compares Game.GUID with the version on the Hub (once per version, cached). Nucleus keys each player's game and profiles by GUID, so a changed one drops the game from their list. Also nucleus lint --hub; setting splitscreenme.lint.compareWithHub.
  • Option values a saved profile turns into text. Game.AddOption(..., [true, false]) gets a warning: a profile gives the value back as "True", so Context.Options["x"] == true stops matching. Use text values.
  • Files that aren't UTF-8, and a backslash in GameName. A file saved as ANSI (accented letters arrive broken in Nucleus) gets a warning, and a \ in Game.GameName is an error: the Hub install names the file after it and fails.
  • Names that don't exist. A stray word or a typo of a variable ("system.cfg", sdfsdf) is now an error: Nucleus throws "sdfsdf is not defined", and at the top level the handler doesn't load. Names from the handler's plugins (pluginsInfo.txt in its folder) count as defined.
  • The .NET calls handlers use are known. System.IO.File (Copy, Exists, Delete, ReadAllText…), System.IO.Directory, System.IO.Path.Combine, System.Environment.UserName and System.Threading.Thread.Sleep now have completion, hover docs and argument checks, and a typo like System.IO.File.Exsts is flagged. Other .NET names are still allowed. Suggested by messenils.
  • Warns about options set too late. A new too-late rule flags Game.GUID, Game.GameName, Game.MaxPlayers, Game.SupportsKeyboard, Game.Description or Game.AddOption inside Game.Play or another callback: Nucleus reads them when it loads the handler or on the setup screen, so there they do nothing. Other Game options, such as Proto Input or FakeFocus, still work inside Game.Play.
  • Checks for options with a fixed format. A new value-format rule catches a Game.CustomHotkeys entry that isn't "true|Toggle HUD|Ctrl|H" (Nucleus then registers none of them), folder lists without folder|destination, a Game.SteamlessPatch Nucleus can't read, and a Game.BinariesFolder with slashes in the wrong place. Each one would otherwise fail the setup or silently do nothing.
  • Test all combinations in Try it. One link runs every player count (up to the handler's maximum), input setup and monitor size, and shows which combinations fail and why. Pick a cell to see that run. The same check as the browser workbench's.
  • Try it with a keyboard and mouse for every player. Choose "each player their own" (or nucleus simulate --keyboard all): every player gets their own keyboard and mouse, as in Nucleus' multiple keyboards and mice mode. Try it says so when the handler doesn't set Game.SupportsMultipleKeyboardsAndMice = true.

🛠️ Improved

  • Screenshots in your theme. The README's screenshots show VS Code light or dark, matching your theme on GitHub.
  • Calling a name that doesn't exist is an error. System.IO.File.Exsts(p) or a misspelled Context function used to be a warning that said the line does nothing; calling it actually throws, so Nucleus stops there. Reading or setting a misspelled name is still a warning.
  • Game.ForceFinishOnPlay is flagged as historical. It comes from the original Nucleus Coop, where it closed running copies of the game before each player; today's Nucleus doesn't read it and always closes leftover copies when a session starts. The linter now says so in a warning, instead of "probably a typo", with a fix that removes the line.
  • AI agents report their own time. The agent skill tells AI agents that use WakaTime to register as agents (category ai coding, ai_line_changes), not as the person.

🐛 Fixed

  • Try it's Game.Folder is where the Hub installs the handler. handlers\<GameName> instead of handlers\MyHandler, as the Hub install names the folder after the game name.
  • Try it without Game.Play. Game.OnFinishedSetup now runs, and Game.OnStop sees the last player's Context, as in Nucleus (it reported "Context is not defined" before).
  • Context paths in Try it. Context.UserProfileConfigPath, UserProfileSavePath and the Documents paths now get the values Nucleus gives them, including moving a "Documents\" path to DocumentsConfigPath. The docs no longer claim that ten Context values, such as Context.Options, are copied from Game.
  • Try it follows Jint for System calls. A misspelled System.IO name fails, a call with the wrong number of values fails, and System.Environment.UserName is text, checked against the real engine.

🙏 Thanks

  • messenils for asking for the System.IO lines.

📦 Install: download splitscreenme-vscode-v0.3.0-beta.1.vsix below, then in VS Code run Extensions: Install from VSIX… (Ctrl+Shift+P). New to the tools? Start with the intro and install guide and TESTING.md.
🤖 AI agents: nucleus.js (below) is the command-line tool and MCP server: node nucleus.js mcp. See the README.
🌐 Offline workbench: workbench.html (below) is the whole browser workbench in one file; open it locally or host it yourself.
💬 Feedback: tester feedback form.