cyberpresidentvanellope/Bubberstation
1
0
Fork 0
mirror of https://github.com/Bubberstation/Bubberstation.git synced 2026-08-21 20:20:33 +01:00
Code Issues Packages Projects Releases Wiki Activity

Updates the UpdatePaths Readme to have more information (#68436)

Browse Source 
Updates the UpdatePaths Readme to have more information

Hey there,

Several people were relying on this to teach them about UpdatePaths, and it missed out on a bunch of needed information (such as the important of including `@OLD` in order to ensure that you do not discard old variables (properties)) when you transfer from an old path to a new path. I added that in, as well as leveraged the capabilities of it being a MD file to get some nicer looking formatting in as well.
This commit is contained in:
san7890
2022-07-17 01:46:09 -07:00
committed by GitHub
parent bee6a45152
commit 459cb12eb7
1 changed files with 19 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files
tools/UpdatePaths/readme.md
+19 -16
View File
@@ -1,32 +1,35 @@
HOW TO USE:
Drag one of the scripts in the “Scripts” folder onto the .bat file “Update Paths” to open it with the .bat file. Let the script run.
# UpdatePaths
Use this tool before using mapmerge or opening the map in an editor.
## How To Use:
IMPORTANT:
Please tie the script you are making to the associated PR on github and put it in the scripts folder when you are done.
Drag one of the scripts in the “Scripts” folder onto the .bat file “Update Paths” to open it with the `.bat` file (or use the Python script directly depending on your operating system). Let the script run to completion.
For example: 67107_Turf_Updates_2
Use this tool before using MapMerge2 or opening the map in an map editor. This is because the map editor may discard any unknown paths not found in the /tg/station environment (or what it builds after parsing `tgstation.dme`).
## Scriptmaking:
HOW TO MAKE A SCRIPT:
This tool updates paths in the game to new paths. For instance:
If you have a path labeled
/obj/structure/door/airlock/science/closed/rd
If you have a path labeled `/obj/structure/door/airlock/science/closed/rd` and wanted it to be `/obj/structure/door/airlock/science/rd/closed`, this tool would update it for you! This is extremely helpful if you want to be nice to people who have to resolve merge conflicts from the PRs that you make updating these areas.
and wanted it to be
---
/obj/structure/door/airlock/science/rd/closed
### How do I do it?
This tool would update it for you! This is extremely helpful if you want to be nice to people who have to resolve merge conflicts from the PRs that you make updating these areas.
Simply create a `.TXT` file and type this on a line:
How do you do it?
Simply open a notepad and type this on a line:
/obj/structure/door/airlock/science/closed/rd : /obj/structure/door/airlock/science/rd/closed
`/obj/structure/door/airlock/science/closed/rd : /obj/structure/door/airlock/science/rd/closed{@OLD}`
The path on the left is the old, the path on the right is the new. It is seperated by a ":"
If you want to make multiple path changes in one script, simply add more changes on new lines.
Putting `{@OLD}` is important since otherwise, UpdatePaths will automatically discard the old variables attached to the old path. Adding `{@OLD}` to the right-hand side will ensure that every single variable from the old path will be applied to the new path.
---
### On Variable Editing
If you do not want any variable edits to carry over, you can simply skip adding the `{@OLD}` tag (although this is not advisable under normal circumstances). There are also a bunch of neat features you can use with UpdatePaths variable filtering, such as ensuring all new paths get a certain variable edit, filtering old paths if they have a certain variable edit, or even splitting one path into multiple paths on a map. You can find out more about this by reading [https://github.com/tgstation/tgstation/blob/master/tools/UpdatePaths/\_\_main\_\_.py#L9](https://github.com/tgstation/tgstation/blob/master/tools/UpdatePaths/__main__.py#L9).
If you get lost, look at other scripts for examples.