Mapping - Revision history

Unkn0wn Gh0st: Adds information about Fork

2024-12-20T17:59:19Z

Adds information about Fork

← Older revision		Revision as of 13:59, 20 December 2024
Line 23:		Line 23:
	Make sure to install it into your PATH on Windows. You should get python from [https://www.python.org/ python.org]. Versions installed from the windows store sometimes cause build issues.		Make sure to install it into your PATH on Windows. You should get python from [https://www.python.org/ python.org]. Versions installed from the windows store sometimes cause build issues.

	=== Get GitHub Desktop ===		=== Get GitHub Desktop or Fork ===
	In order to download the repository itself, you do so by installing a software called "Git". However since Git isn't a very intuitive piece of software, you can get a third-party UI to do the same thing.		In order to download the repository itself, you do so by installing a software called "Git". However since Git isn't a very intuitive piece of software, you can get a third-party UI such as fork to do the same thing.

	[https://desktop.github.com/ GitHub Desktop] is the UI many Delta-V contributors use, and ~~that's what I'll show you how to use~~.		[https://desktop.github.com/ GitHub Desktop] is the UI many Delta-V contributors use(Lies).

			[https://git-fork.com Fork] is another great choice and is beloved by many contributors upstream and at Delta-V.

	=== Set up GitHub Desktop ===		=== Set up GitHub Desktop ===
	Once installed, put in your GitHub account details, select "Clone Repository from the internet" and select the fork of Delta-V you made. After it downloads the files, select that you want to "Contribute to the parent project", then go to File > Options > Appearance and select Dark Mode. Once you've done that, congratulations! You've set up your repository's master branch.		[[File:Githubdesktop.png\|thumb\|default\|A screenshot of GitHub Desktop's main screen.]]Once installed, put in your GitHub account details, select "Clone Repository from the internet" and select the fork of Delta-V you made. After it downloads the files, select that you want to "Contribute to the parent project", then go to File > Options > Appearance and select Dark Mode. Once you've done that, congratulations! You've set up your repository's master branch.

			If you want to view the files, click the button that says "Show in Explorer" and it will bring up a window of File Explorer in the directory it installed to.

	[[File~~:Githubdesktop~~.~~png\|thumb\|default\|A screenshot of GitHub Desktop~~'~~s main screen~~.]]		=== Set up Fork ===
			Once you get to the website it will say that Fork cost $60 USD but that is not true. Fork is like Winrar where you can get a free "evaluation" forever and just keep telling them "I don't want to purchase". You then want to log into your GitHub account go to the top left where <u>File</u> and click "Clone..." and you want to put in the Git URL to the Delta-V clone you made. After it downloads you'll be pretty much set up and ready to go.

	~~If you want to view~~ the ~~files, click the button that says~~ "~~Show in Explorer~~" ~~and~~ it ~~will bring up a window of File Explorer in the directory it installed~~ to.		The rest of the guide is written for "GitHub Desktop" usage but its pretty similar to Fork so it won't be that hard to figure out.

	=== Server & Client ===		=== Server & Client ===

Adeinitas: It became .net 8.0 since this was touched. I love legacy pages

2024-12-19T07:27:39Z

It became .net 8.0 since this was touched. I love legacy pages

← Older revision		Revision as of 03:27, 19 December 2024
Line 13:		Line 13:
	Go to [https://github.com/DeltaV-Station/Delta-v/ Delta-V's GitHub page] and, while signed in, click the "Fork" button in the upper-right.		Go to [https://github.com/DeltaV-Station/Delta-v/ Delta-V's GitHub page] and, while signed in, click the "Fork" button in the upper-right.

	=== Get .NET 7.0 ===		=== Get .NET 8.0 ===
	.NET (aka "dotnet") is a prerequisite for working with RobustToolbox (the SS14 engine). You can first check to see if your computer already has it installed on your Windows PC by going into ''command prompt'' and typing '''dotnet --version'''.		.NET (aka "dotnet") is a prerequisite for working with RobustToolbox (the SS14 engine). You can first check to see if your computer already has it installed on your Windows PC by going into ''command prompt'' and typing '''dotnet --version'''.

	[[File:Dotnetversion.png\|thumb\|center\|It should look something like this.]]		[[File:Dotnetversion.png\|thumb\|center\|It should look something like this.]]

	If you don't have dotnet version 7.0 or higher, you can [https://dotnet.microsoft.com/en-us/download download it from Microsoft's page]. You may need to restart your PC after installing dotnet.		If you don't have dotnet version 8.0 or higher, you can [https://dotnet.microsoft.com/en-us/download download it from Microsoft's page]. You may need to restart your PC after installing dotnet.

	=== Get Python 3.7 or higher ===		=== Get Python 3.7 or higher ===

Unkn0wn Gh0st: Updates Images

2024-12-02T03:56:03Z

Updates Images

← Older revision		Revision as of 23:56, 1 December 2024
Line 48:		Line 48:

	Once you do this, it will open up an instance of Command Prompt where it has the directory set to your repository.		Once you do this, it will open up an instance of Command Prompt where it has the directory set to your repository.
			[[File:CMD prompt.png\|center\|thumb]]
	[[File:~~Cmdinitial~~.png\|~~frame~~\|~~center~~]]

	Now, type or copy this entire command:		Now, type or copy this entire command:

Line 65:		Line 63:
	'''dotnet run --project Content.Client --configuration Release'''		'''dotnet run --project Content.Client --configuration Release'''

	Doing this successfully will launch the SS14 client, and present you with the following screen:		Doing this successfully will launch the SS14 DeltaV client, and present you with the following screen:
			[[File:ClientBuiltDeltaV.png\|center\|thumb\|800x800px\|Note that it doesn't matter what you put for "Username."]]
	[[File:~~Clientbuilt~~.png\|thumb\|~~800px\|center~~\|Note that it doesn't matter what you put for "Username."]]

	Congratulations, you can now join your own server and experiment in your own little environment! Much like with the server, you'll be able to launch the client with '''runclient.bat''' until you make a new branch with updates.		Congratulations, you can now join your own server and experiment in your own little environment! Much like with the server, you'll be able to launch the client with '''runclient.bat''' until you make a new branch with updates.

Line 78:		Line 74:

	'''mapping 5'''		'''mapping 5'''

			If you get the reply "Map 5 already exists." then use a different number.

	You will then be placed in map 5 at the coordinates 0,0. Map 5 will be completely empty, and you will notice the hotbar on the side of the screen is that of the admin ghost commands. If you were to hit the "''Show Debug Monitors''" key (by default "F3"), it will show you in the upper-left that you are on "''Map=5, X=0.00, Y=0.00''", and for future reference, this is how you find the ''GridUid'' of the grid you are currently on top of. The next coordinate to run is:		You will then be placed in map 5 at the coordinates 0,0. Map 5 will be completely empty, and you will notice the hotbar on the side of the screen is that of the admin ghost commands. If you were to hit the "''Show Debug Monitors''" key (by default "F3"), it will show you in the upper-left that you are on "''Map=5, X=0.00, Y=0.00''", and for future reference, this is how you find the ''GridUid'' of the grid you are currently on top of. The next coordinate to run is:

Unkn0wn Gh0st: Made mapping commands easier to see and copy

2024-11-30T07:30:42Z

Made mapping commands easier to see and copy

← Older revision		Revision as of 03:30, 30 November 2024
Line 51:		Line 51:
	[[File:Cmdinitial.png\|frame\|center]]		[[File:Cmdinitial.png\|frame\|center]]

	Now, type '''dotnet run --project Content.Server --configuration Release''' and wait for a moment. You will see a long list of yellow text (warnings) in the window, eventually giving way to the following text:		Now, type or copy this entire command:

			'''dotnet run --project Content.Server --configuration Release'''

			and wait for a moment. You will see a long list of yellow text (warnings) in the window, eventually giving way to the following text:

	[[File:Serverbuilt.png\|frame\|center]]		[[File:Serverbuilt.png\|frame\|center]]
Line 57:		Line 61:
	Once you've reached this point, the server is built and does not need to be built again until you make a new, updated branch. Any time in the future you want to run the server, you can use the '''runserver.bat''' file in the repository.		Once you've reached this point, the server is built and does not need to be built again until you make a new, updated branch. Any time in the future you want to run the server, you can use the '''runserver.bat''' file in the repository.

	Next, you need to build the client. It's exactly the same process, except you run the command '''dotnet run --project Content.Client --configuration Release'''. Doing this successfully will launch the SS14 client, and present you with the following screen:		Next, you need to build the client. It's exactly the same process, except you run the command:

			'''dotnet run --project Content.Client --configuration Release'''

			Doing this successfully will launch the SS14 client, and present you with the following screen:

	[[File:Clientbuilt.png\|thumb\|800px\|center\|Note that it doesn't matter what you put for "Username."]]		[[File:Clientbuilt.png\|thumb\|800px\|center\|Note that it doesn't matter what you put for "Username."]]

Velcroboy: /* Server & Client */

2024-02-19T16:27:53Z

Server & Client

← Older revision		Revision as of 12:27, 19 February 2024
Line 57:		Line 57:
	Once you've reached this point, the server is built and does not need to be built again until you make a new, updated branch. Any time in the future you want to run the server, you can use the '''runserver.bat''' file in the repository.		Once you've reached this point, the server is built and does not need to be built again until you make a new, updated branch. Any time in the future you want to run the server, you can use the '''runserver.bat''' file in the repository.

	Next, you need to build the client. It's exactly the same process, except you run the command '''dotnet run --project Content.Client --configuration ~~RELEASE~~'''. Doing this successfully will launch the SS14 client, and present you with the following screen:		Next, you need to build the client. It's exactly the same process, except you run the command '''dotnet run --project Content.Client --configuration Release'''. Doing this successfully will launch the SS14 client, and present you with the following screen:

	[[File:Clientbuilt.png\|thumb\|800px\|center\|Note that it doesn't matter what you put for "Username."]]		[[File:Clientbuilt.png\|thumb\|800px\|center\|Note that it doesn't matter what you put for "Username."]]

Velcroboy: /* Server & Client */

2024-02-19T16:27:28Z

Server & Client

← Older revision		Revision as of 12:27, 19 February 2024
Line 51:		Line 51:
	[[File:Cmdinitial.png\|frame\|center]]		[[File:Cmdinitial.png\|frame\|center]]

	Now, type '''dotnet run --project Content.Server --configuration ~~RELEASE~~''' and wait for a moment. You will see a long list of yellow text (warnings) in the window, eventually giving way to the following text:		Now, type '''dotnet run --project Content.Server --configuration Release''' and wait for a moment. You will see a long list of yellow text (warnings) in the window, eventually giving way to the following text:

	[[File:Serverbuilt.png\|frame\|center]]		[[File:Serverbuilt.png\|frame\|center]]

Floofers: Fix setting dev link

2023-10-21T12:25:22Z

Fix setting dev link

← Older revision		Revision as of 08:25, 21 October 2023
Line 5:		Line 5:
	== Setting up the Development Environment ==		== Setting up the Development Environment ==

	There exists [https://docs.spacestation14.io/~~getting~~-~~started~~/~~dev~~-~~setup~~ another, more comprehensive guide] on this topic, but if you just want to get down to the basics and don't have time to read all that, there's this:		There exists [https://docs.spacestation14.com/en/general-development/setup/setting-up-a-development-environment.html another, more comprehensive guide] on this topic, but if you just want to get down to the basics and don't have time to read all that, there's this:

	=== Create a GitHub account ===		=== Create a GitHub account ===

Colin Tel: /* Setting up the Development Environment */ Added step for Python

2023-08-10T10:59:11Z

Setting up the Development Environment: Added step for Python

← Older revision		Revision as of 06:59, 10 August 2023
Line 5:		Line 5:
	== Setting up the Development Environment ==		== Setting up the Development Environment ==

	There exists [https://docs.spacestation14.io/getting-started/dev-setup\| another, more comprehensive guide] on this topic, but if you just want to get down to the basics and don't have time to read all that, there's this:		There exists [https://docs.spacestation14.io/getting-started/dev-setup another, more comprehensive guide] on this topic, but if you just want to get down to the basics and don't have time to read all that, there's this:

	=== Create a GitHub account ===		=== Create a GitHub account ===
Line 19:		Line 19:

	If you don't have dotnet version 7.0 or higher, you can [https://dotnet.microsoft.com/en-us/download download it from Microsoft's page]. You may need to restart your PC after installing dotnet.		If you don't have dotnet version 7.0 or higher, you can [https://dotnet.microsoft.com/en-us/download download it from Microsoft's page]. You may need to restart your PC after installing dotnet.

			=== Get Python 3.7 or higher ===
			Make sure to install it into your PATH on Windows. You should get python from [https://www.python.org/ python.org]. Versions installed from the windows store sometimes cause build issues.

	=== Get GitHub Desktop ===		=== Get GitHub Desktop ===

Colin Tel: /* Setting up the Development Environment */ fixed links

2023-08-09T19:20:50Z

Setting up the Development Environment: fixed links

← Older revision		Revision as of 15:20, 9 August 2023
Line 18:		Line 18:
	[[File:Dotnetversion.png\|thumb\|center\|It should look something like this.]]		[[File:Dotnetversion.png\|thumb\|center\|It should look something like this.]]

	If you don't have dotnet version 7.0 or higher, you can [https://dotnet.microsoft.com/en-us/download\| download it from Microsoft's page]. You may need to restart your PC after installing dotnet.		If you don't have dotnet version 7.0 or higher, you can [https://dotnet.microsoft.com/en-us/download download it from Microsoft's page]. You may need to restart your PC after installing dotnet.

	=== Get GitHub Desktop ===		=== Get GitHub Desktop ===
	In order to download the repository itself, you do so by installing a software called "Git". However since Git isn't a very intuitive piece of software, you can get a third-party UI to do the same thing.		In order to download the repository itself, you do so by installing a software called "Git". However since Git isn't a very intuitive piece of software, you can get a third-party UI to do the same thing.

	[https://desktop.github.com/\| GitHub Desktop] is the UI many Delta-V contributors use, and that's what I'll show you how to use.		[https://desktop.github.com/ GitHub Desktop] is the UI many Delta-V contributors use, and that's what I'll show you how to use.

	=== Set up GitHub Desktop ===		=== Set up GitHub Desktop ===

Debug at 02:23, 2 July 2023

2023-07-02T02:23:38Z

← Older revision		Revision as of 22:23, 1 July 2023
Line 1:		Line 1:
	This is a general overview of getting started with mapping in SS14.		This is a general overview of getting started with mapping in SS14.

	Mapping in SS14 is done by downloading a repository (e.g. ~~Nyanotrasen~~), building the server and client on your own machine, then joining a local server that permits you to access admin-only tools, like the mapping tool, ability to view variables, fixgridatmos, etc.		Mapping in SS14 is done by downloading a repository (e.g. Delta-V), building the server and client on your own machine, then joining a local server that permits you to access admin-only tools, like the mapping tool, ability to view variables, fixgridatmos, etc.

	== Setting up the Development Environment ==		== Setting up the Development Environment ==
Line 10:		Line 10:
	Go to https://github.com/ and create an account.		Go to https://github.com/ and create an account.

	=== Make a fork of ~~Nyanotrasen~~ ===		=== Make a fork of Delta-V ===
	Go to [https://github.com/~~Nyanotrasen~~/~~Nyanotrasen Nyanotrasen~~'s GitHub page] and, while signed in, click the "Fork" button in the upper-right.		Go to [https://github.com/DeltaV-Station/Delta-v/ Delta-V's GitHub page] and, while signed in, click the "Fork" button in the upper-right.

	=== Get .NET 7.0 ===		=== Get .NET 7.0 ===
Line 23:		Line 23:
	In order to download the repository itself, you do so by installing a software called "Git". However since Git isn't a very intuitive piece of software, you can get a third-party UI to do the same thing.		In order to download the repository itself, you do so by installing a software called "Git". However since Git isn't a very intuitive piece of software, you can get a third-party UI to do the same thing.

	[https://desktop.github.com/\| GitHub Desktop] is the UI many ~~Nyanotrasen~~ contributors use, and that's what I'll show you how to use.		[https://desktop.github.com/\| GitHub Desktop] is the UI many Delta-V contributors use, and that's what I'll show you how to use.

	=== Set up GitHub Desktop ===		=== Set up GitHub Desktop ===
	Once installed, put in your GitHub account details, select "Clone Repository from the internet" and select the fork of ~~Nyanotrasen~~ you made. After it downloads the files, select that you want to "Contribute to the parent project", then go to File > Options > Appearance and select Dark Mode. Once you've done that, congratulations! You've set up your repository's master branch.		Once installed, put in your GitHub account details, select "Clone Repository from the internet" and select the fork of Delta-V you made. After it downloads the files, select that you want to "Contribute to the parent project", then go to File > Options > Appearance and select Dark Mode. Once you've done that, congratulations! You've set up your repository's master branch.

	[[File:Githubdesktop.png\|thumb\|default\|A screenshot of GitHub Desktop's main screen.]]		[[File:Githubdesktop.png\|thumb\|default\|A screenshot of GitHub Desktop's main screen.]]