Soap Box
A tiny games console in a window: play little Lua games (carts) on a pastel handheld, and make your own with its code editor. Comes with Bubble Pop. Only you need it.
| Last updated | an hour ago |
| Total downloads | 1 |
| Total rating | 0 |
| Categories | Mods |
| Dependency string | SoapieScripts-Soap_Box-0.1.0 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2305README
Soap Box
A tiny games console in a window: play little Lua games (carts) on a pastel handheld, and make your own with its code editor. Comes with Bubble Pop. Only you need it.
| Open with | Click the handheld icon |
| Who needs it | Only you (others see you playing a handheld without the mod) |
Not fully tested: the window, Bubble Pop and the code editor work in the game; the copy saved when you change Bubble Pop, renaming carts and jumping to an error's line haven't all been tried yet.
A tiny games console in a window: play little games ("carts") on a 192 x 128 screen with 16 colours, inside a pastel handheld, and make your own in its code editor. Click the handheld icon to open it.
- Playing. Opening the window gives Soap Box the keyboard: the arrow keys or WASD move, Z or Space is the A button, X the B button, and Esc or Enter opens the menu (continue, restart, edit code, carts, close). The mouse works on the screen too, and you can click the handheld's buttons, which light up as they're pressed. Click outside the window and the keyboard goes back to the game, and the cart pauses until you click its screen again.
- Your character. If you're standing when you open Soap Box, your character sits down and plays the handheld console, so other players see you gaming. If you're already sitting, nothing changes, and closing Soap Box never stands you up.
- Bubble Pop comes with it. The kid on the island blows bubbles: aim with the arrows or the mouse and pop them with Z or a click before they float away. Pink bubbles are worth more, gold ones even more, and quick pops build a combo.
- Making games. Click the cart's name in the title row (or carts in the menu) and pick + new cart. It starts with a little demo and opens the code editor. Carts are written in Lua, a small and friendly language. Ctrl+R (or run) plays your code from the start, and Esc goes back to the game. The pencil in the title row opens the editor for the cart that's running. ? in the editor lists every Soap Box function and the 16 colours. Your cart's own functions:
_init()runs once,_update()60 times a second and_draw()after it. - The editor. Shift with the arrow keys, or a mouse drag, selects (double-click selects a word). Ctrl+C, X and V copy, cut and paste (with nothing selected they take the whole line), Ctrl+Z and Y undo and redo, Tab and Shift+Tab indent, and Enter keeps the indentation (one step more after
then,doorfunction). When a cart stops with an error, its screen says what went wrong, and X there takes you to the line, marked in red. - Your carts. They save by themselves, in
Documents\On-Together\Soap Box, as.soapfiles (plain text, so they're easy to back up or pass around). The cart list opens them, renames the one you're editing and opens the folder. Carts that come with Soap Box never change: the first change you make to one saves a copy in your carts, and you carry on with that. - Safe to play. Carts can only draw on their screen and read the controls: they can't touch your files, the internet or the game. A cart stuck in a loop that never ends is stopped with a message instead of freezing the game.
- The window. The title row has the cart's name (click it for the cart list), the pencil, a round button that changes the handheld's colour (pink, aqua, lilac or cream), ? for the controls, the size (S, M or L) and X to close. Drag the title row to move the window anywhere on screen; double-click it to put it back with the other mods' windows.
Drawing sprites, making maps and making sounds come in the next versions: the editor's tabs for them are already there, and sfx() and music() stay silent until then.
Only you need the mod. In the settings file, Shell is the handheld's colour, Size the window's size, SitDown stops your character sitting down, PauseWithoutKeys keeps a cart running while Soap Box doesn't have the keyboard, CartFolder moves the folder for your carts, LastCart is the cart that opens next, WindowX and WindowY are where you dragged the window (-1 keeps it with the other windows), ControlsSeen set back to false shows the controls card by itself again, and WindowKey sets a key to open the window (there's none by default, since other mods use every F key).
Credits. Carts run on MoonSharp, a Lua interpreter by Marco Mastropaolo (BSD licence; the licence text is in the mod's folder). The text uses Monogram, a free pixel font by datagoblin (CC0).
The icon
Like the other mods in this set, Soap Box puts a small pixel-art icon in a row at the bottom-right of the screen. Click it to do what the mod's key does (or to switch the mod on and off, for mods without a key), and hover over it to see its name and key. A green dot means it's on, and a greyed-out icon means it's off. The gear button at the row's right end opens the tray, which holds the icons you've tucked away. Right-click it to arrange the row: drag icons to reorder them or tuck them into the tray. The arrangement is saved in BepInEx/config/IconRow.json and is shared by every mod in this set. The row only shows in a world, while no game menu is open, and hides while Photo Mode is on. The mods' icons and windows also hide and show with the game's eye button, in every window mode.
Settings
After the first launch, the settings are in BepInEx/config/nelphei.ontogether.soapbox.cfg. In r2modman or Gale, open them from the config editor. Each setting has a comment explaining it. Restart the game after changing them. ShowIcon hides the mod's icon.
Mac
Install it through r2modmac. The mods haven't been tried on a Mac yet.
More mods
Other mods in this set: Photo Mode, Emote Sync, Teleport Spots, Song Player, Trace Overlay, Focus Anywhere, Desk Snap, Chat Range, Name Designer, Card Designer, Outfit Slots, Quick Hide, Network Crash Fix, Desk Swarm, Session Manager, Doom Together, Card Table, Buddy Up, Bubble Shell. Source code, and notes on how they've been tested, are on GitHub.
This is an unofficial fan project, not made or supported by GigaPuff.