mirror of
				https://github.com/Resxt/Plutonium-T6-Scripts.git
				synced 2025-10-31 09:57:00 +00:00 
			
		
		
		
	Initial commit
This commit is contained in:
		
							
								
								
									
										2
									
								
								.gitattributes
									
									
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										2
									
								
								.gitattributes
									
									
									
									
										vendored
									
									
										Normal file
									
								
							| @@ -0,0 +1,2 @@ | ||||
| # Auto detect text files and perform LF normalization | ||||
| * text=auto | ||||
							
								
								
									
										78
									
								
								README.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										78
									
								
								README.md
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,78 @@ | ||||
| # Plutonium-T6-Scripts | ||||
|  | ||||
| [](https://plutonium.pw/) | ||||
|  | ||||
| ## What is this? | ||||
|  | ||||
| This is a collection of [Plutonium](https://plutonium.pw/docs/intro/) T6/BO2 scripts I created, written in [GSC](https://plutonium.pw/docs/modding/gsc/).   | ||||
|  | ||||
| Huge thanks to everyone who helped me learn GSC: Birchy, DoktorSAS, FutureRave and other people on Discord. | ||||
|  | ||||
| ## How do I download a script? | ||||
|  | ||||
| ### Compiled / Ready to use script | ||||
|  | ||||
| To download a compiled script, click on a `.gsc` file that **doesn't** end with `-source` and click on `Download`. | ||||
| <details> | ||||
|   <summary>Image</summary> | ||||
|    | ||||
|    | ||||
|    | ||||
| </details>   | ||||
|  | ||||
| ### Source script | ||||
|  | ||||
| Alternatively, if you want to download the source code click on a `.gsc` file that ends with `-source` and click on `Raw`. | ||||
|  | ||||
| <details> | ||||
|   <summary>Image</summary> | ||||
|    | ||||
|    | ||||
|    | ||||
| </details> | ||||
|  | ||||
| Right click anywhere and click on `Save page as` (or an equivalent). | ||||
|  | ||||
| Make sure to put `All` or `Any` for the file type and to add `.gsc` at the end of the file name. | ||||
|  | ||||
| <details> | ||||
|   <summary>Image</summary> | ||||
|    | ||||
|    | ||||
| </details> | ||||
|  | ||||
| ## How do I use a compiled script? | ||||
|  | ||||
| [Follow the instructions in the documentation](https://plutonium.pw/docs/modding/loading-mods/#loading-existing-scripts-on-t6) | ||||
|  | ||||
| Simply drop a compiled `.gsc` file inside `%localappdata%\Plutonium\storage\t6\scripts`. | ||||
|  | ||||
| Note that you can use `map_restart` in the [console](https://plutonium.pw/docs/opening-console/) to quickly restart your current game and reload scripts. | ||||
|  | ||||
| ## How do I compile a script? | ||||
|  | ||||
| <!--- | ||||
| Replace with Plutonium's documentation instead when it's up-to-date | ||||
| ---> | ||||
|  | ||||
| - Download [GSC Tool](https://github.com/xensik/gsc-tool/releases/latest) | ||||
| - Read the [instructions to compile a file](https://github.com/xensik/gsc-tool#usage) | ||||
|  | ||||
| It should look similar to this   | ||||
| `gsc-tool.exe comp t6 "C:\Users\Resxt\AppData\Local\Plutonium\storage\t6\scripts\mapvote.gsc"`   | ||||
|  | ||||
| If after opening the file you see that it has a lot of non readable characters this means that it was successfully compiled. | ||||
|  | ||||
| ## What are compiled and source scripts? | ||||
|  | ||||
| Before downloading a script it's important to understand what compiled and source scripts mean.   | ||||
| A source script is the script in a human readable form (a text file), this is how the script is written.   | ||||
| A compiled script is simply a source script that has been compiled by an interpreter to make it readable by the game.   | ||||
| At the time of writing, T6 cannot read source scripts so you have to compile them to allow the game to read them. | ||||
|  | ||||
| So if you only want to use a script and you don't want to edit a script or review its code you can simply [download a compiled script](#compiled--ready-to-use-script) and [start using it](#how-do-i-use-a-compiled-script). | ||||
|  | ||||
| All of my scripts always come as two files: | ||||
|  | ||||
| - script.gsc (compiled script) | ||||
| - script-source.gsc (source script) | ||||
		Reference in New Issue
	
	Block a user