#Your First Godot Port, AKA Russian Pirate Pack TM

22 messages · Page 1 of 1 (latest)

plush stag
#

According to advice from my fellow porters, to reduce the amount of testing for our limited number of testers, and to allow new porters to familiarize themselves with portmaster, I have made available a number of ready to play frt/godot games that only have the finishing touches remaining. As well as a set of instructions for you to bring them to completion (or to play them ahead of time).

Please comment below which of the available port you would like to bring to completion and I will mark them as selected
[] = Available [✅] = Selected
Games:
[] Jewelry Remake https://3boood-pro.itch.io/jewelry-remake
[✅] Legend of Lumia https://wizbane.itch.io/the-legend-of-lumina
[] Leticia Land https://libra-bits.itch.io/leticia-land
[✅] Long Spear https://tecosv.itch.io/long-spear
[] Major Firepower vs C.O.Z.Y https://swansonggames.itch.io/major-firepower
[] Overclocked https://escada-games.itch.io/overclocked
[✅] PYK https://rafalkowalski.itch.io/pyk
[✅] Super Mario 63 Redux (redux) https://github.com/GTcreyon/SM63Redux or https://creyon.itch.io/sm63redux
[] Rhythm Match https://slime-team.itch.io/rhythm-match
[] Untold https://johngabrieluk.itch.io/untold
[] Save'en https://lefumis.itch.io/saveen
[✅] Scale the Skull Tower https://cortok.itch.io/scaletheskulltower
[] Sealed Bite https://securas.itch.io/sealedbite-gamejamversion
[] Symmetry https://hacktrout.itch.io/symmetry
[] Twin 1986 https://zicman.itch.io/twin-1986-full
[✅] Wll.Jmp https://swagnerrc.itch.io/wlljmp
[] Yuna and the Moonstealers https://fouriertransformer.itch.io/yuna-and-the-moonstealers
[✅] Ziggurat https://nethead.itch.io/ziggurat

Advanced ports:
[] Brotato https://store.steampowered.com/app/1942280/Brotato/

#

How to play these ports:

  1. Download the game from the link above of your choosing (if a linux link is provided please choose that one).
  2. Add the content from the corresponding zip file in zip file attached to this post to your ports folder. In the selected zip there should be 2 files, one folder and one .sh file
  3. Extract the .pck file from inside the downloaded file to the "gamedata" inside the folder you just extracted.
  4. Rename the .pck file to the same name as folder you extracted earlier. (So if archive in this post contained a folder called "gamaname", your .pck file should now be named "gamename.pck")
#

How to complete a port:

  1. Test the port and ensure it works on your device with the available itch.io file, if it does not start try the following:
  • If there are multiple downloads available for different platforms, try another one.
  • Test an older version of the game if available
  • Test the port on a different OS. For example, if you are running JelOS, try it on a system running ArkOS
  • If it still does not run, feel free to tag me and I will try my best to help you
  1. Test and make sure that controls feel natural, if they do not, do the following:
  • Open the .gptk file contained inside the game folder in a text editor of your choice
  • Find out which keys correspond to action you would like to rebind, either by reading a provided keybind by the developer, or by trying the game on a different platform
  • Add key corresponding to the action to the button you would like to perform it in the .gptk file. For example if you know that the Z key on a keyboard makes you jump, and you would like the A button to make you jump. one of the lines in the gptk file would look like this: 'a = z'. More advanced instructions can be found here: https://github.com/EmuELEC/gptokeyb
#
  1. Update names
  • Make sure that the folder name does not contain any spaces and is only lowercase. You do this by editing both the folder name, as well as the following line in the .sh file 'GAMEDIR=/$directory/ports/Game Name/' where 'Game Name' should be changed to 'gamename'
  • Change the required .pck name to be the same name as the one included in the itch.io download, meaning if the download from itch.io contains a .pck file named 'gamedata_LINUX.pck' the following line in the .sh file should be changed to reflect that. Meaning the line 'PCK="game.pck"' would become 'PCK="gamedata_LINUX.pck"'. This is to reduce the number of installation steps for the user.
  • You can also change the name of the .sh file itself to more closely reflect the name of the game, for example changing 'redux.sh' to 'Super Mario 63 Redux.sh'.
  1. Create JSON. This is where you add you own credit.
  • Fill in the following form: https://portmaster.games/port-json.html
  • Once you have filled it in, click Download JSON, and add the json file to your ports folder (The same folder as your .gptk file).
  • If a porter reports that your game does not work on their device you may have to click on one of the options at the end of the form, but for now leave it on the default options.
    The instructions part should look something like this (unless .pck distribution is granted of course):
    'Link: [LINK TO ITCH.IO PAGE]
    Instructions:

  1. Download [NAME OF FILE] from the link above

  2. Extract [NAME OF .PCK FILE] to the Gamedata folder inside [NAME OF PORT FOLDER].

  3. [Optional] Ask the developer of the game to allow us to distribute the .pck file of their game.

  • If you want help with how to formulate such a message there are prior messages you can copy from this discord.
  1. Create a testing thread here, tagging it for testing, and copy your installation instructions. as well as the following form:
    [] AmberELEC
    [] ArkOS
    [] Jelos
    [] 480x320
    [] 640x480
    [] 720x720
    [] Higher Res
#

Once all boxes have been filled by testers, and no other issues have been noticed you can then submit a PR request to the Portmaster github, making sure to also include a screenshot. If you have any questions about this step please ask Cebion for further details or ask in "port-help".

If any step of this process confuses you please leave ask in "port-help" or message me for help.

If you would like to on any port under "Advanced Ports" please ask me for details, and make sure you already own a steam copy.

#

Extra notes:
Untold: 3D title, would probably play a little better if the screenshake effect was removed, can by done by recreating the project in gdre_tools and changing the godot code
Jewelry remake: Tanks pretty heavily in later levels

#

This sure was an essay to write, I probably could have finished up most of these in the time it took lol

#

Hopefully it can pay of in giving a new clueless porter something easy to start off with/ familiarizing them with portmasters file syntax

calm thorn
#

👍

i think the "corresponding zip file in zip file attached to this post" is missing?

plush stag
swift cargo
#

@plush stag One of the games i just did is on your list: The legend of lumina. You can mark it as selected.

calm thorn
#

✅ scale the skull tower

calm thorn
#

✅ ziggurat

calm thorn
#

✅ started on pyk

fleet frigate
#

✅ Wll.Jmp

calm thorn
lofty yew
#

what is advanced about porting brotato?

plush stag
# lofty yew what is advanced about porting brotato?

If I remember correctly the game's pck needed some patching out of calls to steam as well as some other minor changes to be able to run correctly. Some of this was done by the original "Russian Pirate PackTM" author, and some by myself. So you would either need to replicate these changes, or DM me so I can send you the file with those changes to be able to create an xdelta or similar patch against the original steam files.

fleet frigate
#

✅ Long Spear

tawdry cove
#

hmmmm

night cobalt
shy agate
#

Jewelry Remake

[x] r36s
[x] darkos
[x] 640x480

Gamedata

THWACKPCK="JewelryRemake.pck"

Gamedata

THWACKPCK="Jewelry Remake.pck"

You need to change the name.
The game runs, but the frame rate is low.