Pulsar

Pulsar
Authors:	Melg, Brawlboxgaming
Type:	Riivolution
Creator Version:	1.1.0
Engine Version:	1.1.0
Date of latest version:	2024-02-15
Download:	Pulsar Pack Creator
Source:	GitHub
Discord Server:	https://discord.gg/Wd8uGCrDVg

Overview

Pulsar is a custom track distribution engine created by Melg and Brawlboxgaming. It comes with its own creator software, which makes pack creation and updating very simple, and a plethora of features, the biggest of which are completely flush Cup Select Expansion, ghost saving, and in-game settings. The game engine is built on Kamek made by Treeki and the creator software is developed in C#.

Creating a Distribution

A Pulsar Pack is composed of 4 aspects:

A track folder in which the SZS files have been renamed.
An assets folder which contains all custom files necessary for the engine to function.
A binaries folder where the code binary and pack configuration file live. All binaries use the .pul extension (and it can be bound to the software for fast access).
A ghosts folder; each track has its own subfolder where ghosts are saved, and the folder also contains a text file to help users know which folder corresponds to which track.

The engine has been designed with ease of use as its upmost priority. After downloading and launching the creator software, you have two options for tracks:

You can fill each cup manually.
You can click the mass import button and copy/paste all of your tracks' information. You can then move all of your SZS files to the input folder (which can be opened using a button), select them all, and drag them to the first file name box.

Once your cups are defined, simply choose which options you would like your pack to contain, choose a Wiimmfi region, input a pack name and press the "Build Full Pack" button. Your pack will be created and be ready to use as-is.

Maintenance and Updating

In the software, you can open your Config.pul file with the software, or use the "Import Config" button. Your entire configuration will show in the software and you can modify. Any track update, for example, a different SZS file, will invalidate all ghosts made on the previous version. If the code binary itself has been updated since you created your pack, you can download it directly, but it is strongly recommended to instead update your software. Click the "Program Settings" button and then the "Update" button. If an update is found, wait for the software to reopen, and then import and build your configuration again.

Features

The engine currently does not include its own FAT library. Consequently, on console it uses Riivolution's own library, meaning files get saved on the SD card, and on Dolphin it saves files on the NAND, located in "\Dolphin Emulator\Wii\title\00010004\PACKNAME".

Core

Fully functional cup select and slot expansion, including 8 cups per page and BRSTM support (include a BRSTM of your choice to your My Stuff, and rename it to the track index or to the case-sensitive track name).
In-game settings, accessible both offline, on the main online menu, and in friend rooms.
Ghost saving, along with full support for staff ghosts, which reward players with trophies upon being beaten.
Up to four time trial modes (150cc, 150cc feather, 200cc and 200cc feather).
My Stuff (via Riivolution) support: Pulsar does not modify any vanilla SZS, which allows players to use their own custom texture hacks or any SZS (such as the often modified MenuSingle/Race/Common) with no conflicts.

UI

The BRCTR, BRLYT and TPL of virtually all of Pulsar's UI modifications can be customized and are located in "PACKNAME/Assets/UIAssets.szs" and "PACKNAME/Assets/RaceAssets.szs".

A speedometer that is flush with the game UI.
In-game crediting of custom track authors, by virtue of a message at the start of a race. It is mandatory for pack creators to fill the author fields.
Between Races Change Combo, which is accessed via a button on the VR page, along with another button to completely randomize your next combo.
Team Selection, where the host of a room can manually set the team of each player. Team VS has been modified to play exactly as normal VS while keeping the coloured minimap icons and the scoreboard after races. This makes it easy to play clan wars or any sort of group event.
Boot to Wiimmfi directly.
Better ghost replay which displays the normal race interface and allows multi-ghost watching and point-of-view switching. The time difference UI is shown for each ghost on the track and has been moved.

Gameplay

Both versions of Conditional Out of Bounds by Riidefi and kHacker35000vr.
Custom number of races per GP.
Lap & Speed Modifier (MrBean35000vr, Geeh and MrEvil)

Optional:

200cc.
Mega Thunder Clouds (model by Atlas).
Ultra Mini-Turbos: Inspired by Mario Kart 8 Deluxe, Karts can charge a third tier of mini-turbos, which is both longer and gives a stronger speed boost than super mini-turbos, indicated by purple flames. Moreover, any boost (including other mini-turbos) that is released while the UMT is still going preserves the stronger boost.
CLF78 and stebler's Feather (model by Atlas).
Custom CC distribution.

Sound

BRSAR entry size patch to prevent any BRSTM from cutting off.
Conditional channel switch: The game will only switch channels (on Toad's Factory, Koopa Cape, Dry Dry Ruins, Moonview Highway and Bowser's castle) if the currently playing BRSTM has at least as many channels as the BRSAR entry requires.
BRSTM expansion: When you include any BRSTM in your My Stuff, you can either rename it to a vanilla BRSTM name, in which case the game will play said BRSTM on all tracks that use that vanilla track's slot, or you can rename it to the index of a track (Cup 6 track 3 would be 4x5 + 3 = 23.brstm) or the case-sensitive track name as it appears in-game directly (Amanita Abyss.brstm) to play that BRSTM on only a specific track. The latter naming has priority on the former.
Optional Music Speedup on final lap: Instead of switching to the _f.brstm file, the music simply gradually speeds up over 5 seconds. This makes the transition smooth but also completely circumvents the need for a _f.brstm.

Network

Friend Rooms can only be joined by people on the same pack (meaning the exact same configuration file).
Host Always Wins: Instead of going through track votes, the host of the room chooses the first track directly before starting the GP, and then each subsequent track is chosen at the end of the race through a custom menu.
Worldwides still function like on vanilla and all gameplay modifications are disabled.

Misc.

Display finish time instead of name on the results leaderboard
Do not hide position tracker at the end of races (MrBean35000vr)
Coloured Minimap (Riidefi)
A file gets automatically created when the game crashes. That file is located in the pack folder. It can be opened with the creator to display crash information.

Optional:

Mii heads (JoshuaMK)
Draggable blue shells (MrBean35000vr)
Battle glitch (XeR)

Using Pulsar as a library

Everything about Pulsar is open source. The code can be directly modified (for example if you want your own version of 200cc) but also expanded upon. An upcoming version of the Custom Track Testing Pack (the pack used to test tracks for bugs) as well as Variety Pack will show how to do so. Once you have made your code modifications and obtained your own Code.pul and added any files you need to the Assets.szs, you can use the software as if you wanted to make a normal distribution, but instead use the "Build Config Only" button.

Media

Pulsar Pack Creator Tutorial

Version History

Creator

Version	Date of release	Information
v1.0.0	2024-02-10	First release
v1.0.1	2024-02-11	Pasting is no longer possible in numbers-only boxes. RKG dropping now functions as expected. CC probabilities boxes now function better.
v1.1.0	2024-02-15	Now allows custom cup icons and names. They can both be mass imported. PNG is the recommended format for the images. Galaxy colosseum is now selectable as a music slot. Battle arenas are no longer selectable as track slots. The input/output folders no longer get created at the wrong location when the software is started through a .pul file. Attempt at making the mass import window work for everyone (the save button is somehow sometimes outside of the window and inaccessible), although this likely still does not address the issue. Fixed massive trophy counts getting written to config files.

Engine

Version	Date of release	Information
v1.0.0	2024-02-10	First release
v1.1.0	2024-02-15	Pulsar data on dolphin now lives in Dolphin Emulator/Wii/shared2. It was previously in Dolphin Emulator/Wii/title/00010004 but some users' NAND had specific permissions prevent the use of that location. Cup Select buttons are no longer mistakenly inaccessible. If no controller input is made on the strap screen, boot to Wiimmfi will be skipped (as it stands, no way to determine which controller the player is attempting to use). Flaps now work as expected. RKG ghosts no longer get incorrectly overwritten on load (currently, this causes slightly slower ghost loading times which is especially noticeable on console). Improved sample inheritance file for those wanting to write their own codes. Settings can now be accessed on packs that have neither feathers nor 200cc. Fixed a crash that would occur on packs where cups got added. Fixed BMG issue in GP mode. Fixed race count related crash in friend rooms. Fixed bad cup ordering on packs with 8 or fewer total cups. Fixed junk being written to leaderboard files.