H-uru
/
moul-assets
mirror of https://github.com/H-uru/moul-assets.git
17
4
Fork 3
Code Releases Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
681 Commits
1 Branch
0 Tags
38 GiB
 
 
 
Tree: d07a638686
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'd07a638686'
${ noResults }
moul-assets/CONTRIBUTING.md

4.4 KiB
Raw Blame History

Contributing

We are glad that you are interested in contributing to moul-assets! We happily accept contributions, including:

  • bug reports
  • bug fixes
  • art assets
  • and much more!

Please take a moment to read these guidelines to ensure your contributions are accepted.

Project Goals

The goal of the moul-assets project is to provide baseline assets for the MMORPG Myst Online: Uru Live to be used in the Plasma Engine. In the interest of doing so, we have identified these project goals:

  • providing a coherent, well-tested content baseline for Myst Online: Uru Live shard operators
  • conservatively improving the base game Ages as created by Cyan Worlds, Inc. with objective bug fixes and enhancements
  • improving the player experience
  • integrating new content that serve a clear purpose in enhancing Myst Online: Uru Live as a video game
  • avoiding nontrivial breaks in compatibility with the official Myst Online: Uru Live (again) game run by Cyan Worlds, Inc.

Further, we have identified these non-goals:

  • accepting all fan created content
  • accepting fan created content published on any particular shard, including the official Myst Online: Uru Live (again) game run by Cyan Worlds, Inc.
  • accepting fan content geared toward role-playing done on any particular shard, including the official Myst Online: Uru Live (again) game run by Cyan Worlds, Inc.
  • supporting exploit-based gameplay

These are tasks that run contrary to the project's priorities stated above, and as such are not likely to be accepted if submitted for inclusion. Any changes implementing these are best maintained on an independent fork.

Getting Involved

Real-time discussion with team members and other contributors is an excellent way to begin contributing. We welcome feedback and discussion of proposed changes. Active maintainers can be found on the Guild of Writers IRC channel:

  • Server: irc.guildofwriters.org:6667
  • Channel: #writers

We also use the Guild of Writers' forum for more permanent discussions. Further, many team members can also be found on the OpenUru discord.

Reporting Bugs and Requesting Features

We use GitHub's issue tracker to list bugs and feature requests. Good bug reports tend to have:

  • a summary or background
  • steps to reproduce the bug, the more specific, the better!
  • what you expect to happen
  • what actually happens
  • any other pertinent notes, such as why you think the issue is happening and any mitigation you attempted

Submitting Changes

Changes to moul-assets generally fall under two categories: objective and subjective. Before submitting any changes to the repository, you will need to request access to the LFS store.

Submitting Objective Changes

Objective changes tend to be limited in scope and are generally minor adjustments or fixes to content already accepted to the repository. These changes should require limited discussion and should demonstrate a clear and apparent improvement to the game. These changes may be developed and submitted using GitHub Flow. To propose changes to the repository:

  • fork the repository and make your changes as described by GitHub flow
  • open a pull request and ensure that all test coverage and continuous integration passes
  • document in the pull request body what you have changed and why

Submitting Subjective Changes

Subjective changes tend to be larger in scope and generally require discussions around myriad aspects of their development. This can be a lengthy process involving many revisions to your contribution. At this time, we are not interested in unsolicted submissions of new Ages. New Ages should be submitted to the individual Shard(s) that you would are interested in Age appearing on.

Subjective changes to the game are, by their very nature, subjective, hence our reluctance to impose and document a specific review process. However, all subjective submissions should:

  • be relatively bug-free
  • be tested against the Myst Online: Uru Live version of the Plasma Engine by the creator (at minimum)
  • match the art style of the currently accepted content both visually and audibly
  • not look like a "video game"
  • have largely correct lighting