RumbleParkPen

A VRChat-style pen for RUMBLE. Draw 3D strokes in mid-air.

Works in the Park and the Gym. Deliberately unavailable in matches.

Requirements

Installed automatically by the mod manager:

• MelonLoader 0.7.3
• RUMBLE Modding API 5.4.0
• UI Framework 0.10.2

Getting the pen out

Hold Primary + Secondary on your off hand (the left hand by default) for a moment. There's a Spawn / Put Away button in the settings menu too.

Controls

These are the defaults, all can be customised.

Rebinding

Each of the actions has its own Controls section in the settings menu:

• Binding - Select the button to use, or no binding, or custom binding
• Custom - appears when the binding is set to Custom. Type a combination, joined with +, and every part has to be held at once. For example NonDominantPrimary+NonDominantSecondary, DominantTrigger+Key:F7 keyboard. None leaves the action unbound. You can also use this to keep it to left or right controller instead of dominant/non-dominant e.g. LeftGrip, RightStickClick...
• Activation - Trigger while Held, Tap, or after Holding for a period of time. Draw and Erase are always While Held.
• Hold Time - appears when the activation is Hold.

Sharing one button between a Tap and a Hold works too, which is how the default tap-to-undo and hold-to-clear are on the same button.

Drawing with other people

Strokes are shared with everyone in the room who also has the mod. Players without the mod are unaffected and will only see you waving your hand around like a weirdo.

• The eraser rubs out anyone's strokes.
• Hold-to-clear only wipes your own strokes, so nobody can wipe the room by accident.

Settings

Settings are in the UI Framework menu (F9), saved to UserData/RumbleParkPen/config.cfg.

• Pen: hand, ink colour, line width, pressure sensitivity, detail, eraser radius
• Pen Fit: move the position of the pen relative to your hand
• Drawing: save, load, clear, delete, and auto-save/auto-load
• Multiplayer: share yours, show others', sync-on-join
• Controls: rebind every action, and set how each one activates

Saved drawings

Each scene keeps its own file under UserData/RumbleParkPen, so a Park drawing and a Gym drawing never overwrite each other, and a drawing reloads exactly where you made it. There may be some existing bugs related to saving drawings when changing map.

Version 1.1.0

Every input is now rebindable.

• Each action can be fully custom rebound
• General optimizations on erasing and memory allocation

Version 1.0.1

Fixes a bug where this mod could throw errors on the game clients of players who did not have it installed. Please update, v1.0.0 can still crash people.

• Nothing is broadcast now. Now uses Photon player properties, so players without the mod receive nothing from this mod at all. In past, the 'HELLO' broadcast sent on entering the Park reached everybody, and RUMBLE Modding API dispatched an incoming event through an unguarded dictionary lookup that throws when the mod is not installed.
• Re-registers itself with the Modding API if its event registration is dropped, which before may have cause crashes.
• Strokes drawn by a player are now removed when that player leaves the room.
• A player running an incompatible protocol version is named in the log instead of being ignored silently.

Version 1.0.0

Initial release.

Drawing

• VRChat-style pen that 3D strokes, in the Park and the Gym
• Trigger to draw, grip to erase whole strokes, tap B/Y to undo, hold B/Y to clear
• Pressure sensitivity — squeeze the trigger harder for a thicker line
• 10-colour palette cycled with A/X on the pen hand

Multiplayer

• Strokes stream to other players with the mod as you draw them, in batches
• Arriving in a room replays existing drawings, and yours replay to players who arrive later
• Addressed only to players known to have the mod, so nobody else's log is affected

Saving

• Each scene keeps its own save file under UserData/RumbleParkPen
• Optional auto-save on leaving and auto-load on arrival