Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
94 lines (59 loc) · 6.42 KB

CONTRIBUTING.md

File metadata and controls

94 lines (59 loc) · 6.42 KB

How To Contribute To RE:SS3D

This document outlines the guidelines for contributing to the SS3D project. If you have any questions, feel free to ask on our discussions page or discord server.

If you're interested in contributing assets, check out https://ss3d.space/contribute/, which has a breakdown of the different contributions types as well as links for asset kits, guides, and to-do boards for each type.

The game itself is made in Unity, written in C#, and uses FishNet for networking. Follow the links for our guides on these.

Using Github

Git Clients:

To get a hold of the project, you need a git client. Git is the software that manages the source. GitHub is the website that we use to host it. If you are new, GitHub Desktop is easiest for beginners.

Forking The Repository:

To start contributing via GitHub, first you should fork this GitHub repository, using the 'Fork' button in the upper right corner of this page. Naturally, this requires a GitHub account. You will commit your changes to your fork and then make a pull request to merge it into our repository. Learn more about pull requests here.

Over time your fork will become out-dated as the main project's repository continues to be added upon. GitHub has made a pretty clear guide on how to sync your fork, to keep it up to date with the SS3D repository.

Issues:

If you are unfamiliar with issues, GitHub has a helpful guide here. Use one of the templates when creating your issue, as the information it requests helps you help us help you more efficiently.

For new contributors, check out our issue label Good First Issue for available beginner level tasks.

Pull Requests:

Pull requests allow the maintainers to review any changes and verify they are wanted and don't break anything in the existing project. Similarly to issues, you should use the template when making a new PR and provide as much detail as possible.

  • Pull requests should merge into the develop branch.
  • The title and description should be clear and concise.
  • If the PR is attempting to fix an issue, reference the issue number in the PR description ("Fixes #number").
  • Include pictures/videos in your pull request whenever possible.

Git Commit Messages:

  • Use the present imperative tense ("Add feature" not "Added feature", "Move cursor to..." not "Moves cursor to...").
  • Limit the first line to 72 characters or less.
  • Reference issues and pull requests liberally after the first line.

Naming Files and Folders:

When (re)naming files and folders always do so using 'PascalCase', this makes naming consistant which helps with organization and clarity.

E.X. "LockerDoorAnimationController.file" would be correct, not "Locker Door Animation Controller.file", not "lockerdoor animation controller.file", not "AnimationController - LockerDoor.file".

Game Testing & Reporting Bugs:

Before reporting a bug, please check the reported bugs on our issues page to see if the bug has already reported.

Explain the issue clearly and include any additional details to help maintainers reproduce the problem:

  • Use a clear and descriptive title for the issue to identify the problem.
  • Describe the steps to reproduce the problem as specifically and detailed as possible.
  • Describe the behavior you observed and point out the problem with that behavior.
  • Describe the expected behavior that should happen instead.
  • Include pictures/videos to show the steps taken to demonstrate the problem.
  • Include your game version and OS to help track if the problem is version specific.
  • Include your game settings to help track if the problem is settings specific.
  • If you're reporting a game crash, include a crash report with the error log. It's location depends on your operating system, so follow this official guide.
  • If the problem isn't triggered by a specific action, describe what you were doing before the problem happened.

Project Maintainers

The set of people responsible for making sure the contribution cycle runs smoothly and that the changes made to the project are wanted, correct, and functional. On the Github these people are labeled "members", and on the Discord they are known as "Centcom".

The project maintainers have the following goals:

  • To prioritize issues and pull requests so the most important changes get focused on and added to the project first.
  • To make sure no contributions, however minor, don't get overlooked. Despite some contributions having greater priority, all contributions are created equal.
  • To verify that contributions comply with our standards, will not break the project, and are wanted, before they are accepted into the project.

Setting Up & Running The Project

Downloading Unity:

Option A.

  1. Clone this (SS3D) repository.
  2. Download Unity Hub.
  3. Download the current Unity version that the project tells you.

Option B.

  1. Clone this (SS3D) repository.
  2. Download Unity 2021.3.0f1 or newer and open the folder containing the project in Unity.

Running The Game:

First you will need to either build the project using Unity or download one of our offical builds from our GitHub Releases page, alternatively you can visit https://ss3d.space/download/ which will automatically download our latest release from GitHub.

Running the game itself is a little bit more complicated than it needs to be at this time but will be simplified as our development progresses. The details of running the game have been moved here. If you are only interested in play testing the game by yourself, just follow the 'Joining a Server' page.