You are viewing a potentially older version of this package. View all versions.
BallJack-SpotPins-1.4.0 icon

SpotPins

Save per-map spots, update native session markers after travel, and share JSON SpotPacks with a clean menu and controller support.

Date uploaded 2 weeks ago
Version 1.4.0
Download link BallJack-SpotPins-1.4.0.zip
Downloads 209
Dependency string BallJack-SpotPins-1.4.0

README

SpotPins

Find a spot you love, save it, and travel back whenever you want. Your spots stay organized by map, with notes, favorites, colored pins and full controller navigation.

Requires ReSkate 2.1.4 or newer with plugins enabled.

Start here

  1. Press P to open SpotPins, or open Plugins > Spot Pins in ReSkate.
  2. Choose Save Spot to keep your current location.
  3. Choose Travel beside a saved spot to return to it. Its More menu contains notes, rename, favorite, color, guide, update and delete.
  4. With a controller connected, close the menu after traveling and let the automatic native-marker attempt finish. Settings > Close after travel can close it for you.

Use the mouse wheel, scrollbar or D-pad to move through the list. A selects; B goes back or closes. The sidebar switches between Spots, History, Spot Packs, Settings and Session.

What's new in 1.4.0

Feature What it does Where to find it
Native session markers Automatically attempts to update the game's own marker after SpotPins travel. Enabled by default; requires a connected controller. Settings > Advanced > Auto marker
Record your shortcuts Press your own key combination instead of choosing a preset. The list remains available for controller use. Settings > keyboard key / Return key
A cleaner workspace Square controls, consistent dropdowns, color-accented cards and clear controller focus across the custom screens. Press P
Safer controller travel Close after travel waits until A is released, preventing the same press from pushing the skater. Settings > Close after travel
Choose your arrival Explicitly request the board or an on-foot arrival. Settings > Advanced > On Board

Travel and the game's native marker

Auto marker is experimental and enabled by default. It has been confirmed working during local in-game testing. Different controllers, game states or other input mods may prevent it from running.

After an accepted travel request, SpotPins waits until you are near the destination and gameplay has input. It then waits 0.5 seconds and adds a D-pad Up hold to your connected controller. The default and minimum configurable hold is 1.2 seconds. You can change the delay, hold duration and controller under Settings > Advanced.

  • Close menus after travel. The attempt waits while a menu is open and expires after 30 seconds. Close after travel is optional; release controller A to let it close.
  • A message saying the game reported a marker save means SpotPins observed a native saved event. Sending Up alone is not treated as success.
  • The attempt copies your real controller input and releases its temporary input layer when finished or interrupted. Another mod owning that controller can block it. Keyboard-only play without a connected controller cannot use this method.
  • Turn Auto marker off to use the ordinary manual reminder instead. The reminder is on by default and also serves as a fallback when an automatic attempt fails; you can disable it in Settings.

ReSkate asks for input.write so SpotPins can briefly add Up to controller input, and marker.read so it can observe native marker-save events. This updates the game's session marker; it does not add SpotPins to the game's world map.

Make the list yours

Open a spot's More menu to rename it, add notes, favorite it, change its pin color or visibility, and start guidance. Names wrap when needed; notes appear below them. Color and visibility controls keep the menu open while you edit.

Use All / Favorites to filter and Saved / Nearest to sort. Reorder changes your saved order: drag a grip with the mouse or use Move up / Move down with a controller. Choose Saved sorting to see that order. World markers can be hidden globally in Settings or individually in More.

Guide me displays a temporary target and distance, with a left/right cue when the target is off screen. Stop Guide in the sidebar ends it.

Position updates and deletion ask for confirmation. Undo Edit appears in the sidebar after a successful delete or position update. It restores the latest such edit on that map; another delete/update replaces it. Undo is held in memory and clears when the plugin reloads or the game restarts.

Shortcuts and controller use

P opens or closes the menu by default. In Settings, select the keyboard key and choose Record shortcut, press a letter, digit, F1–F12 or Space with optional Ctrl/Shift/Alt, then release to save. Choose from list is the controller-friendly alternative. Cancel, timeout or focus loss keeps the previous shortcut. ReSkate's own saved Binds overrides take priority.

The Return shortcut defaults to R, enabled. While skating, it returns to where you were immediately before your last SpotPins travel. It alternates between those two positions and only works on the current map. The return point and History are session-only.

An optional L3 or LB + L3 menu shortcut is available in Settings; it is off by default. D-pad Up/Down stays in the current section, Left reaches the sidebar from the leftmost control, and Right returns to content. B backs out of a dialog or screen before closing the workspace. Controller focus has a gold outline.

Native text editors remain in use for names, notes, search, filenames and coordinates so paste and game-supported text entry remain available.

SpotPacks: try, import and share

Spot Packs > Review starter offers three San Vansterdam spots: Seaside Park, Carvatron 2 and Casper Campus. Nothing is added automatically, and the starter spots are not marked as favorites. Review them, choose the ones you want, then select Add selected.

To export, choose Spot Packs > Export pack > Export map, enter a filename and save. Existing files are never overwritten. The JSON contains this map's spot names, notes, coordinates and headings; it does not include your favorites or settings. A pack holds up to 64 spots from one map.

To import a friend's pack:

  1. Open Spot Packs > Folder guide to see the path for your installed copy.
  2. In Windows File Explorer, open your ReSkate folder, then Mods\.reskate_plugin_data\BallJack-SpotPins\SpotPacks. Create the folders if needed, or export once to create them. Copy your friend's .json file there.
  3. Load the pack's map. Choose Spot Packs > Import pack, then Refresh after adding files. Only compatible packs for the current map appear; the list shows up to 64 matching packs.
  4. Select Load, review the spots, toggle any you do not want, and choose Add selected. Cancel leaves your list unchanged. Matching coordinates are skipped.

Imports add independent copies to your saved list. Removing the original JSON later does not remove imported spots. Exports are written to the same folder; send the JSON to a friend to share it. Different installation folder names have separate data folders, so follow the in-game Folder guide if your path differs. SpotPins does not open File Explorer for you.

Session Spots: multiplayer preview

Experimental: sharing has not yet been tested between two players in a live multiplayer session. Delivery or confirmation may fail. Both players need compatible SpotPins copies. Switch sharing off under Settings > Advanced if desired.

In a lobby, open Session, choose one saved spot from the current map and a player, then choose Send spot. This sends one spot, not an entire SpotPack. A delivery confirmation means the other copy received the offer, not that the player saved it.

Received offers show the sender and map. The player chooses Travel, Save or Dismiss; receiving never automatically teleports or saves. Travel and Save require the matching map. Save adds a copy without replacing existing spots. Unsaved offers are temporary and disappear when you leave the session or switch sharing off. Multiplayer travel remains subject to game and host rules.

Advanced travel

On Board: On explicitly requests board arrival; Off requests arrival on foot. The game or session may still determine the final state.

Enter coords starts with your current X, Y, Z. Y is height. Floor off preserves the entered height, including sky drops. Floor on checks below the target and uses a detected surface; if none is detected, travel is canceled. Distant collision may not be loaded, and neither mode guarantees an obstacle-free destination. Review and confirm before traveling. Return is available after an accepted request.

Long-distance travel may need a moment for scenery and collision to stream in.

Updating and your saved spots

Spots and settings are local and stored by ReSkate separately from the mod package. Keep the package name and installation folder unchanged when updating. A renamed or separate copy has its own storage. This package contains no player save/settings file to replace yours.

Spot lists are separated by map. Unreadable saved records are preserved rather than overwritten, and failed saves keep the previous data. ReSkate may ask you to approve permissions again after an update.

CHANGELOG

Changelog

1.7.0

  • Built against ReSkate2.1.4-5-hotfix-2. Added seeded native menu/replay-editor awareness, guarded travel/flag/shortcut entry and interruption cleanup. The lightweight native Plugins launcher waits for host menus and closing A/B/Escape to release before opening the workspace.
  • Added Smart Pins: cached nearest/range selection, bounded projection, viewport culling, UTF-8 clipped names and label decluttering. Default24 nearest within500m; controls and Unlimited options are nested in Advanced > Pins / Recovery. Guide stays independent; HUDs hide behind own/native menus.
  • Added reviewed selective JSON exports from larger libraries, explicit64 selection limit and filename/collision/stale-list guards. Extended v2 exports preserve valid long names/notes; short packs remain v1. Lobby protocol/limits stay unchanged.
  • Added five rotating file-backed recovery snapshots before delete/update/import, manual backup and current-map reviewed Add copies. Snapshots never consume pooled player storage; errors preserve prior recovery and do not block ordinary edits.
  • Fixed Scout's invalid Escape-containing key masks; masks now change on transitions. Corrected arrival Left/Right signs, exact modifier checks, reserved/boost shortcut conflicts, legacy re-enable validation and interruption reopen race. Retained native flight fallback and1.2s marker minimum.
  • Preserve unknown preferences on settings writes. Removed dormant quickbar and duplicate old native editing UI. Restored current Scout documentation and corrected stale native-flag wording.
  • Full regression/portable compilation passed; independent health/UX/API reviews8.9/9.0/9.1 out of10. Live native-menu/controller timing and two-player Session delivery remain test gates.

1.6.1

  • Added a recordable Scout start/end shortcut, F4 by default, with an enable switch, conflict checks and release gating. Existing open/Return shortcuts remain separate.
  • Added adjustable Scout flight with five saved speeds (3/6/12/24/48 m/s), look sensitivity and invert Y. D-pad Up/Down or =/- changes speed in flight; Shift/L3 boosts 3x. Native ReSkate flight remains a selectable fallback. No engine preferences or extra permissions are changed.
  • Fixed Y/G appearing ineffective: it now locks a valid destination, matches arrival direction to the camera and confirms the heading. Added 15/30/45-degree arrival turn settings.
  • Consolidated Scout controls/settings on one controller-accessible screen. New camera ownership/capture is released on exit, interrupted entry, focus/map loss and unload; stationary poses skip redundant camera writes.
  • Expanded automated Scout coverage to 15 module scenarios plus actual-main shortcut/flight/save integration; the new camera mode still needs a live game check.

1.6.0

  • Added experimental Scout Mode: native freecam spot authoring while a per-plugin hold keeps the skater in place. Includes a checked surface preview, lock/arrival-heading controls, native naming, duplicate skipping and atomic normal spot saves.
  • Added controller/keyboard Scout help and an aim-range dropdown. Release gates, focus/map/unload cleanup, asynchronous camera confirmation and rollback protect input and resource ownership. Requires skater.control permission.
  • Included per-spot native-map flag publishing and its manager, reviewed Session SpotPack transfers, optional local chat shortcuts and compact guidance from the local 1.5.x builds. Native card names remain generic; multi-card/Session/Scout live tests remain open.
  • Corrected standard and compact guidance camera handedness and ahead/behind cues. Unchanged verified flags no longer rewrite tracking, while failed writes still retry.
  • Retained spot/settings keys, installation identity and legacy flag tracking. Package contains no player saves, exports, source tests, helper executables or development backups.
  • Independent Scout review: 8.7/10 for a release candidate with experimental behavior disclosed. Native-map waypoint capture remains a documented future host-API addition, not an advertised working feature.

1.5.1 (local test build)

  • Final quality pass: corrected standard/compact guide left-right directions against the native camera basis, clarified directly ahead/behind cues, and skipped unchanged flag tracking writes while retaining failed-save retries.

  • Replaced the single moving meetup flag with independent flags linked to stable local spot identities. Publish all processes this map's entire saved list through an observed, serialized queue; single-spot publish remains available.

  • Added Map Flags beside Save Spot, with named status rows, tracked/present/missing/protected counts, explicit Refresh, Stop batch and confirmed Remove all. Cleanup leaves saved spots intact.

  • Fixed native-map-deleted flags requiring two publishes: the next explicit Publish safely replaces the missing object. Failed/refused replacement preserves tracking, and no flags are recreated in the background.

  • Preserved tracking across rename/reorder/position changes and fixed heading-only updates, including verification of the new heading before reporting success.

  • Retained legacy tracking in its original key and migrate into separate v2 storage. Reject malformed records; protect externally changed poses; stop on storage failure, ambiguous placement or disappearing prior flags.

  • Idle and draw paths do not scan world objects. Overlapping flags are skipped; normal game/host limits apply. Generic native card naming is clearly disclosed because the current API has no per-flag naming parameter.

  • One local map card is user-confirmed. Multiple simultaneous local cards and live multiplayer remain to be tested. Existing published package and release ZIP are unchanged.

1.5.0 (local test build)

  • Added explicit native-map meetup flag publishing, moving and removal using the Build Kit object API. Tracks one verified object per map in separate storage; confirmation, ownership checks, async timeout and host-rule handling protect unrelated objects. Native map-card visibility needs in-game verification.
  • Added reviewed Session SpotPack transfer: acknowledged record chunks, bounded retries, sender validation, size/inbox limits and expiry. Nothing is imported or traveled to on receipt. Reuses atomic same-map import with duplicate skipping. Real multiplayer is still untested.
  • Added optional private lobby /spot commands with name-collision fallback, exact current-map name matching and confirmation for flag creation.
  • Added optional compact bearing/distance guide HUD and six numeric bindings for a future Studio-authored native frontend. The native frontend asset is not included.
  • Nested all new controls under Settings > Advanced > Integrations. Preserved ordinary spots, native marker input behavior, storage keys, shortcuts and JSON file workflows.
  • Split new services into small modules with explicit dependencies. Idle flag/pack/guide paths skip object scans, session polling and camera reads. Cached Session roster while its screen is open, retried guide cleanup, and fixed pack inbox/controller navigation.
  • Requires ReSkate 2.1.4-2 and world.objects, chat.commands and ui.models permission approval. Not packaged as a public release yet.

1.4.0

  • Automatic native session markers after travel: a connected controller briefly holds D-pad Up after arrival. Enabled by default, with an off switch, timing/controller choices, native save-event confirmation and a manual reminder fallback. Requires the new input.write and marker.read permissions; native-marker support remains experimental.
  • A new workspace across Spots, History, Spot Packs, Settings and Session, with square controls, clearer typography, pin-color accents, consistent dialogs, selected-option dropdowns and improved empty states.
  • Record keyboard shortcuts using letters, digits, F-keys, Space and modifier combinations, or choose from a controller-friendly list. Canceling or losing focus preserves the previous shortcut.
  • Close on Travel waits for A release so the selecting press cannot carry through as a push. On Board On/Off now explicitly requests board/on-foot arrival.
  • Fixed shortcuts becoming blocked after native Plugins-page edits or interrupted dialogs. Failed settings saves preserve preferences and restore prior shortcut bindings.
  • Preserve unreadable saved spots instead of overwriting them; reject unsupported imported/edited data. Improved text fitting for wide and Unicode names, notes and pack rows.
  • Cached list layouts and text fitting, with throttled nearest sorting and no idle marker/controller work when the corresponding features are inactive.
  • Session Spots remains experimental and has not been tested between two players in a live multiplayer session.

1.3.0

  • Redesigned the spot list, with compact cards, a More menu, draggable scrollbars, smoother spot-list movement, and matching confirmation dialogs.
  • Added optional guidance with distance and a left/right camera cue, plus an optional on-board arrival request.
  • Added experimental Session Spots for sending and receiving individual spots. Multiplayer sharing has not yet been tested in a live session.
  • Added an Advanced settings screen and refined controller navigation and shortcut defaults.
  • Added a one-step Undo for the most recent spot deletion or position update.
  • Added coordinate travel with an optional floor check, a confirmation, and support for exact-height destinations.

1.2.0

  • Redesigned SpotList with distinct Spots, History, Spot Packs, and Settings views and coordinated pack review screens.
  • Added continuous mouse and D-pad scrolling and an optional saved-order editor with drag handles and controller buttons.
  • Show only packs for the current map during import and include map information in exports.
  • Added opt-in starter pack and a review screen for selecting spots.
  • Added JSON SpotPack import and export for the current map. Imports add independent copies and skip duplicate locations.
  • Added a files permission for SpotPack import and export, with an in-game folder guide.
  • Added an optional Return keyboard shortcut, with R as the default key.
  • Improved directional controller navigation, including sidebar focus restoration and scrolling through spot actions.

1.1.0

  • Added an optional, default-on reminder to set your session marker after travel. Change it in SpotList or the Plugins page.
  • Applied Close on Travel and the marker reminder to Return as well as spot and History travel.
  • Reduced idle marker work when floating markers are switched off, and limited controller shortcut polling when it is disabled or gameplay input is unavailable.
  • Clarified travel and empty-list messages and improved shortcut fallback handling.

1.0.0

  • Initial release: save and manage spots per map, travel, history, return, custom names and notes, favorites, search, sorting, floating markers, and keyboard and controller navigation.