Repository navigation
v0.3.0-beta.1 (closed beta)
Pre-release
Pre-release
✨ 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 toolnucleus_format. - A changed Game.GUID before it reaches players. For a handler with a
Hub.Handler.Idline, VS Code comparesGame.GUIDwith 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. Alsonucleus lint --hub; settingsplitscreenme.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", soContext.Options["x"] == truestops 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
\inGame.GameNameis 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.txtin 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.UserNameandSystem.Threading.Thread.Sleepnow have completion, hover docs and argument checks, and a typo likeSystem.IO.File.Exstsis flagged. Other .NET names are still allowed. Suggested by messenils. - Warns about options set too late. A new
too-laterule flagsGame.GUID,Game.GameName,Game.MaxPlayers,Game.SupportsKeyboard,Game.DescriptionorGame.AddOptioninsideGame.Playor another callback: Nucleus reads them when it loads the handler or on the setup screen, so there they do nothing. OtherGameoptions, such as Proto Input or FakeFocus, still work insideGame.Play. - Checks for options with a fixed format. A new
value-formatrule catches aGame.CustomHotkeysentry that isn't"true|Toggle HUD|Ctrl|H"(Nucleus then registers none of them), folder lists withoutfolder|destination, aGame.SteamlessPatchNucleus can't read, and aGame.BinariesFolderwith 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 setGame.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 misspelledContextfunction 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 ofhandlers\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.IOlines.
📦 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.