commit 58b7b60b09f799376e9d7dff57ac52f00477558c Author: tommy Date: Fri Aug 30 06:25:42 2024 +0000 Upload main tutorial diff --git a/Source2Roblox.md b/Source2Roblox.md new file mode 100644 index 0000000..896daa6 --- /dev/null +++ b/Source2Roblox.md @@ -0,0 +1,59 @@ +# Usage + +Inside this ZIP archive you will find: +- Source2Roblox.exe +- credentials.txt + +You must extract this into it's own folder (you can name it anything, but it must have those two files in it) +-# The text file must be on the same level as the executable (both in the same directory, this is important) + +## Credentials +Once you open the `credentials.txt` file, you will see three variable names. +```API_KEY,USER_ID,ACCOUNT_COOKIE``` + +You will need to replace these with your own credentials in order for the asset uploading to work. +Example of it being filled out: +```O2LfPZxcgkOo7CQc,123456,_|WARNING:-DO-NOT-SHARE-THIS.--Sharing-this-will-allow-someone-to-log-in-as-you-and-to-steal-your-ROBUX-and-items.|``` +The commas (",") are used as separators, and the credentials must be in the right order (same order as the variables above this sub-section). + +Follow the tutorial below to properly fill these out. (DO NOT USE YOUR MAIN ACCOUNT FOR ANY OF THESE) + +### Create an API key +Go to and click on the blue button labelled "Create API Key" +Once on the creation page, you'll have to fill out three sections. + +- Section 1 (General Information) + - Name (required): You can name it anything (i.e. "Source2Roblox") + - Description: Doesn't matter, unless you want to make sure what the key is used for. +- Section 2 (Access Permissions) + - API System: you will be asked to select an API system along with its permissions. Simply click the gray "Select API System" drop down. Once you see all the options, find and select "assets". You'll then be able to click the "Add API System" button next to the drop down. After that, you should see a new section appear named "assets" right under the drop down you chose the system from. You'll see a note written in yellow text, this note says "Note! You need both Read and Write operations for creating or updating an asset." which is exactly what you need to do. On the right of this note, click the drop down, find and select both the "read" and "write" options. +- Section 3 (Security) + - Accepted IP Addresses (required): Here, you'll be prompted to add an IP address from which the requests to upload assets will come from. If you want to bother, you can figure out how to add your own IP. If you don't, you can simply put "0.0.0.0/0" as the IP address (this makes it so any IP can use the API key, DO NOT SHARE IT!!!!). Once you have it typed in, click the "Add IP Address" button. + +If everything is filled out correctly, you'll be able to click the "Save & Generate Key". This will give you a *very* long string of random characters that you will need to save to put in your `credentials.txt` file (refer to "Credentials" section near the top of this document). + +### Find your user ID +Simply go to your roblox profile. The link should look like `https://www.roblox.com/users/1455906620/profile`. Your user ID is the numbers right before "/profile". This means that mine would be `1455906620` + +### Find your account cookie +- Go on any page +- Right click in a blank space on the page > Inspect element | OR | Press Ctrl + Shift + I | OR | Press Ctrl + Shift + C +- In the top bar of the window that appeared, you need to find the "Application" tab. +- There will be sections on the right, locate the one named "Storage" and click and expand the item named "Cookies" +- You might see a few URLs in there, find and click on it. +- A bunch of Name-Value pairs will show up, the one you are after is named `.ROBLOSECURITY`. (yes it is the one that starts with a warning) + +## Source2Roblox.exe +Once the ZIP archive is extracted into its own directory, you'll want to open up a terminal in that directory. You can do this by having the file explorer open and clicking the top bar that shows something like "This PC > Documents > Source2Roblox" and typing in "cmd". You can also press the Win key and type in "cmd" and press enter to bring up a terminal (use the "cd" command to navigate to the desired directory, i.e. "cd C:\Users\me\Documents\Source2Roblox") + +Once in a terminal, in the directory, you can finally use the executable. To use it, you simply type "Source2Roblox.exe" with the arguments after it (explained below). To make sure you are in the right place, you can try typing half of the program name ("Source2Roblox.exe") and use the Tab key to see if it autofills. + +Arguments or paremeters will tell the program where to look and what to do, they'll look something like "-game C:\Steam\css\cstrike -map bhop_monster_jam". Below is a list of important arguments you may use. + +- Arguments + - game: This is a directory path where the "cstrike" folder from your desired source game is located. (yes you need the game installed from Steam) + - map: This is the name of the map (bsp file name) you want to convert using the tool (if the file is named "bhop_monster_jam.bsp", you use "bhop_monster_jam" as the name) + - upload: This tells the program wether or not you want it to upload each asset. + - noPrompt: This tells the program to not prompt you for validation each time an asset is to be uploaded. (very useful, does everything on its own) + +Example usage: `Source2Roblox.exe -game C:\Steam\css\cstrike -upload -noPrompt -map bhop_monster_jam` \ No newline at end of file