Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Direction Guidelines

From Delta-V Wiki

Overview & Welcome

Hello! Welcome to the team, where we professionally wyci things. We’ve got a LOT on our plate, as the pseudo development team sans developers. Below you’ll read about our positions, what we do, and what we don’t do! You will find best practices, what to expect, and how we can do better in the future. This will be an evolving and public document; we strive to work with the people in all capacities.

Important Note!

We know your time is valuable. We'll make sure roadmap plans are clear, easy to understand, and broken down into manageable tasks. You can choose what you want to work on. Your contributions are what make Delta V special, and we appreciate every bit of effort you put in!

Code of Conduct

  • Always treat fellow players, staff members, and developers with kindness and consideration. Respect their opinions, even if they differ from your own. Refrain from using offensive language, personal attacks, or any form of discrimination.
  • Collaborate effectively with others, both OOC and in Discord. Be willing to compromise and work together towards common goals. Support your fellow player and server staff, and always prioritize the well-being of the community as a whole.
  • Maintain an approachable demeanor, encouraging players to reach out and share their thoughts and concerns. Listen actively to others, show empathy, and respond with respect. Foster a positive and inclusive environment where everyone feels comfortable expressing themselves.
  • When participating in discussions, ensure that they remain respectful and constructive. Ask for clarification and purpose when someone posts something vague or unclear. Encourage participants to provide evidence, sources, and examples to support their arguments.

Job Requirements

  • You understand the intricacies of the game. This knowledge enables you to make informed decisions, solve problems creatively, and lend an expert opinion.
  • You possess excellent communication skills through writing. You excel at explaining complex concepts clearly and concisely, making it easier for others to understand and engage with the game.
  • You are passionate about the game and appreciate the balance between action-packed moments and immersive roleplay opportunities that Delta V seeks to offer.
  • You are an active member of the Delta V community, regularly contributing to productive discussions.

Content Management

One of the Direction’s main goals is to oversee the curation of content for the Delta-V community. To accomplish this, Direction operates in a Proactive and a Reactive manner. Proactively, they create the Roadmap to indicate what Direction would like to see developed. Reactively, they curate the content submitted to ensure it meets the mission of Delta V. Direction should keep up with the development of these features and offer feedback along the way. Direction guidance ensures that Roadmap content will be developed to the best quality possible and reduce the number of changes that need to be made after the content is presented for official review.

The Roadmap

The Roadmap operates over a few stages.  Concepts on the Roadmap will be selected by the Direction team privately, and the ideas will be established to some level of certainty before being opened to community feedback. Concepts may be highly specific, or rather broad, as long as they have a solid final goal that Direction can guide contributors towards.

Discovery - Curators spend time in Discord channels, forums, and in-game, paying attention to what players are discussing, what they enjoy, and what challenges they face. They monitor dedicated feedback channels, collate suggestions, and identify recurring themes or requests. For more details, refer to Community Management

Conceptualization - Through Discovery, rank Concepts by the following metrics. This is done privately in the #roadmap-development forum, with each Concept having the relevant tags as to its status.

  • Content Impact - Is the content aligned with the Mission of Delta V?
  • Technical Feasibility - What technical skills are needed to complete this project?
  • How can it be broken up into constituent groups?
  • Community Interest - Is the community interested in this specific idea? Is this something they would take kindly to?
  • Direction Priority - How necessary does the direction team believe this is? Are there external pressures pushing for this?

Requirement Gathering - After ranking of Concepts, the Curators should itemize out the following Requirements, with as much detail as possible:

  • What does this Concept seek to do?
  • What problems does it address?
  • What should it do?

Solution Design - Curators should then iterate on the Requirements gathered, and develop the Solution Design. For every requirement:

  • Determine what could be done to resolve this requirement.
  • Itemize these into Tasks, as granular as possible. Are sprites needed? Add a task for a specific sprite.

Publication - At this stage, Direction will share the Solution Design with the public, contained within the global Roadmap. The processes for gathering community feedback are outlined in the Community Management Guidelines. Direction should use this feedback to flesh out Roadmap ideas and finalize them for contributors who wish to begin development.

Design Documents

Design Documents are a tool for Curators and Contributors alike. Design documents are a standardized method of outlining and presenting ideas. It is recommended to use the provided Design Document Template for the sake of consistency. Document templates and the relevant channels can be found in the Discord development category.

Contributors can create Design Documents prior to opening a PR, and have them reviewed by Direction in order to tune their ideas to Direction standards before starting the development process. Contributors are also welcome to create Design Documents for review without the intention to develop them personally. Other contributors can always claim approved documents and begin development themselves!

Curators can collaboratively create Design Documents to address issues laid out in the roadmap. These documents serve as the “Solution Design” step of the roadmap, and will be available to contributors who wish to develop them.

Curators may designate design documents with varying levels of priority according to how pressing Direction finds the issue.

Content Review

Reviewing suggested content involves examining current Pull Requests (“PRs”) or Design Documents and providing feedback. Content review should always involve as many members of Direction as possible, but if only one or two choose to review a piece of content, their opinion holds the same weight as the entire team. If the rest of the team comes to a different decision at a later time, content can always be reverted.

All content must pass the full review process before being approved, with a few small exceptions. Proposed changes for the following do not require a Direction review:

  • Bug fixes
  • Simple tweaks
  • Obvious small changes

When in doubt, the Direction team should be asked if a review is needed.

What do you look for in a review?

  • Fits our MRP Standard - Keeps the balance between action and roleplay, no overpowered stuff or things that break the fun. We want things to make sense to our setting.
  • Fits our Design Ethos - Delta-V is a server founded in analogue design. We want this to be displayed in all the PRs we merge, such that it fits cohesively in the mechanical narrative of the game.

How is a review conducted?

Content review takes place in the #content-review forum channel in the server Discord. The curator who creates a #content-review post assumes responsibility for providing feedback to the author. This includes notifying the author that the content is under review, and summarizing feedback gathered in the post to provide next steps to the author.

If a curator is the author of the content, they should find another curator to assume responsibility for review of the content. Curators should not argue in favor of their own suggested content in posts, in order to ensure it stands on its own merit. Content collaboratively designed by Direction is exempt from this restriction.

Content review is not a vote. Polls are not to be used for anything except timing purposes. Members of Direction are encouraged to give specific feedback on why they support proposed content or what they think should be changed about it, with justification. It is the review post author’s responsibility to summarize this concisely for the content author.

After Direction has discussed the merits of proposed content internally, any final decisions must be communicated to the content author through appropriate channels. This will vary depending on whether the content is a Design Document or a PR.

Design Document review takes place entirely within the Discord. Feedback will be provided to the author through the Discord. Typical decisions include:

  • Approving the document
  • Approving with an elevated priority tag
  • Requesting changes
  • Denying the Document

For Pull Requests, feedback should be communicated to the author through Github. Typical decisions include:

  • Merging the PR
  • Test merging the PR
  • Requesting changes
  • Closing (Denying) the PR

Note: Maintainers have final authority when it comes to the fitness of the PR in terms of code quality and potential bugs or other mechanical concerns.

Deadlines

Directions is a volunteer team. Direction approval is still a requirement for a large portion of new content. In order to prevent bottlenecks and an overall stagnation in new content, deadlines will be enforced for Content Review. Deadlines should be relative to the size of the content. The standard method of tracking a deadline is to create a poll of the appropriate time frame in the review post.

  • Small changes should be subject to 1-2 days of consideration.
  • Major changes may need as many as 1-2 weeks to reach an actionable conclusion.
  • The minimum amount of time for a review is 24 hours.

Curators should notify content authors when their content is under official review, and give them an estimated wait time for feedback. If more review time is required, the author should be notified before the previously stated review period ends.

Deadlines should be established relative to whenever the content is “finalized.” If changes are requested by Direction, the deadline should be extended to the proper amount of time after those changes are implemented by the author.

If, after sufficient requests for input, Direction consistently fails to provide feedback on a PR, the final decision to approve or deny can be made by the Head Maintainer. Direction may request the content be reverted later if need be.

Content Removal

Some currently implemented content will inevitably have to be replaced or removed in order to achieve Direction’s design vision. Direction’s preference should be to replace content that doesn’t meet our standards with improved content where possible.

In order to remove content, Direction must complete each of these steps:

  • Make a list of quantified issues with the content.
  • Create a design document that addresses these issues. If Direction cannot do this, it should be stated on the issue page.
  • Present the issues and design solutions to the community in the Github.
  • Establish a deadline for action to be taken.

If no action has been taken by the deadline, the content will be removed. Appropriate deadlines are as follows. Content examples are not comprehensive.

  • 1 week: Minor content (sprites, mechanical balance of an item, etc.).
  • 2 weeks: Moderate content (roles, machines, etc.).
  • 1 month: Major content (gamemodes, etc.).

Content that is extremely broken or clearly and severely detrimental to the game experience may be removed without this process. Content may be removed upon the original creators request without navigating these processes.

Test Merging

Tmerges may be conducted on PRs whose effects are potentially unclear. A test merge consists of merging content that may be pending changes, or reversion. The purpose of the merge is to gather feedback from an in-game scenario in order to make such decisions. Test merges may be conducted on a test server if appropriate.

Players should be made aware of all active test merges on their current server.

Curators are authorized to manipulate rounds in accordance with Event Management policies in order to test said content.

Test merges must be monitored, or otherwise have an official way of collecting community feedback (such as a feedback forum). If there are specific aspects of the content that Direction is looking for feedback on, this should be made known to the community before the test. Otherwise, a test may be used to discover previously unknown issues with the content, but Direction should take care to ensure content is in the best state possible before conducting a test merge.

Community Management

Through Community Management, Direction interacts with the community of Delta V. Our mission is done to serve them, and we work to encourage their assistance in upholding this mission. It is our responsibility to act responsibly and with respect. Curators listen to what players love (and don't love) about Delta V. They:

Gather Feedback - Curators actively seek out feedback from players through various channels such as surveys, polls, and direct communication. This feedback is essential for identifying areas of improvement and making informed decisions about the future of Delta V. Recording Feedback is just as critical, talk to the team and bring up problem items!

Solve Problems - When players encounter issues or concerns, curators are there to help. They provide guidance, troubleshoot problems, and escalate issues to the appropriate team members for resolution.

Use Communication Channels

  • Announcements - The announcements channel is used to share important updates, server news, event information, and roadmap changes. Announcements must be carefully coordinated with the rest of the team to ensure consistency and accuracy.
  • Polls and Surveys - Polls and surveys are conducted to gather community feedback on specific topics, gauge interest in potential features, and involve players in decision-making processes. Curators recognize that polls and surveys can also yield uneducated opinions, so they work closely with the team to ensure that questions are clearly worded and unbiased.
  • Public Forums - Open forums provide a platform for Direction to speak directly to the community about upcoming changes and get community buy-in for specific ideas. These forums allow for more focused discussions and enable the team to gather valuable insights and feedback.
  • Changelog - The in-game changelog can also be used to share important information with players. Many of our players do not use or check Discord, and elaborating on new features, and bug fixes can be helpful.
  • GitHub - By leveraging GitHub issues and pull requests, maintainers, contributors, and Curators can collaborate effectively, share ideas, and discuss changes.

The roadmap on GitHub plays a crucial role in this communication process. It provides a transparent and accessible overview of the project's goals, priorities, and planned features. By regularly updating the roadmap, Curators can keep contributors informed about where efforts are needed and help align their efforts with the overall mission.

Event Management

Curators design exciting in-game events that encourage awesome roleplay. An event is loosely defined as “taking an action that influences the game as an observer”. Spawning in a spider, or working to establish a custom Syndicate objective would be an event! They, by design, are to give opportunities to spice up regular shifts, providing players with unique roleplay scenarios, which they can react to naturally.

Event Rules

  • Events must be reported. Be robust in your event reporting, especially when giving usually unobtainable items. Be descriptive and attach images or screenshots whenever possible.
    • This serves to show what actions an admin/curator committed during the round and have a space for criticism if needed, to help people improve in their work. Do not be afraid to document your events, even if it didn’t go properly to plan or was a disaster. We’re not here to shame you, we’re all in this together!
  • Events can fail, let them. Be it a syndicate dropping event characters dead, bombing or stealing shuttles, command arresting event characters, let it happen.
  • Events must meet or exceed our MRP Standard.
  • Unless given express permission by a Project Manager or a Game Director, do NOT run Non-Natural Zombies, Deathsquad, CBURN etc.
  • The event should fit within the established lore of the game.
  • Be cooperative with other staff! Work, plan together to make certain dumb ideas into functional, fun things!
  • Do not act CC as some sort of a dictatorship - CC in our server is supposed to be helpful. While they can be strict with some certain things, you should usually play them as supportive.

Eventrunning Practices

  • Events are for everyone’s enjoyment, not just your own.
  • Let your created ghost roles be taken by someone else. You are here to orchestrate the event, not partake.
  • Do not run events that are designed to interact with one person in particular, especially your own character.
  • Do not make ghost roles that are overpowered, or that are intended to be “the protagonist” of the shift.
  • Do not overwhelm the station - If you see that the current security is dealing with very active criminals, maybe it’s best to not send in pirates or other type of a large antagonist group. Evaluate the current round, what gamemode it is and proceed thoughtfully.
  • Feel free to spawn, test things/ideas or doing silly shenanigans in your admin room. This is the one exception to mandatory event reporting, you do not need to report these (but still can if you want!)
    • Spawning in a bunch of ghost roles to do a gag, build some ship/station, play poker or etc., that generally have NO impact on the current shift, is acceptable.
    • Don’t spawn things that could affect glimmer, make people traitor objectives or some other round ending entities.
    • Don’t spawn in a super synth for players. There are some midis that can cause a complete crash.
  • When creating a ghost role, be sure to clearly describe their goal or function in the ghost roles description. While being over-specific limits some room for the player’s own creativity, having a very broad description isn’t good as well. Try to make it short and concise.
    • This is especially important if you’re making a custom antagonist. Be specific of how much the antagonist can cause harm/chaos to the station. You can always use the ghost role rules to be more specific!

Events fall into three broad categories, each with different qualifications and actions required. All events must be reported in the #events channel.

Low Impact

These events that generally do not interfere with the station at all or very little.

Game Administrators, Trial Curators, and Curators may run these with no approval required.

  • By nature, they do not impact the round in any meaningful way and potentially could be mistaken as an in-game event, rather than a curator spawned one in.
    • Curators  have leeway to run nigh unlimited amounts of Low Impact events when Glimmer reaches 900+, including some Medium Impact events. Make items sapient, shrink things, make things strange. Keep your actions within the lore of the game. Feel free to ping the Game Directors for additional questions.
  • Examples of Low Impact events would be
    • Spawning a spider in maints
    • Anything regarding a fax
    • Prayer granting, within reason

Medium Impact

These are events that do interfere with the station, but should not provide the opportunity to derail the station, or round remove players.

Events in this category will be run at Direction discretion, and must be approved by a Trial Curator or Curator first. Ping @Event Management.

  • For easier access for other curators and yourself to repeat these events, it is heavily advised to write it down in #event-library. It will give a clearer picture for yourself and for others.
  • Examples of Medium Impact Events would be
    • Shuttle Events
    • Central Command Inspections
    • ERT on Evac
    • Custom Syndicate Objectives

High Impact

These events are events that heavily interfere with the station, changing the entire shift's course.

Events in this category will be run at Direction discretion, and must be approved by a Curator first. Ping @Event Management for Curator review.

  • These must be planned in advance. There must be a 4 hour notice before the event starts.
    • ERT is exempt from this requirement.
  • These must be written down in #event-library and approved. Write out an event plan, with requirements, objectives, goals, etc.
  • The current gamemode will heavily influence the feasibility of this category of event. You may have to force extended or survival in the pre-round lobby. Use “setgamepreset” to do so. Once the round has started, run “setgamepreset secret” to fix it for future rounds.
  • High Impact events should be carefully examined to ensure they meet or exceed our MRP standards.
  • Do not run these events solo.  You should be working together with a team of Curators(at least 2-3 minimum).  Ask for help in #events, or ping @Curator. Make sure to have some admin(s) with you.