How to Contribute

Learn how to contribute to the Stepcraft Wiki and help the community grow

Welcome to the Stepcraft Wiki community! We're excited that you want to help make this knowledge base even better. Contributing is easy and doesn't require any technical expertise.

Quick Start - Two Ways to Help

1. Edit Any Page Directly

The easiest way to contribute:

  1. Navigate to any page you'd like to improve
  2. Click "Edit Page" in the sidebar (Community section)
  3. Make your changes using GitHub's web editor
  4. Submit your changes - we'll review and merge them!

2. Report Issues or Give Feedback

Found something wrong or have suggestions?

  1. Click "Give Feedback" on any page
  2. Describe the issue or improvement you'd like to see
  3. Submit - we'll address it as soon as possible

What Kind of Contributions Do We Need?

Quick Fixes

  • Fix typos, grammar, or formatting
  • Update outdated information
  • Add missing details to existing pages
  • Improve clarity and readability

Content Additions

  • Document new items, resources, or skills
  • Create guides for game mechanics
  • Add location information and maps
  • Write enemy strategies and tips

Bug Reports

  • Report broken links or missing images
  • Point out incorrect information
  • Suggest improvements to page layout

Writing Guidelines

Content Style

  • Be clear and concise - explain things simply
  • Stay accurate - base information on current game version
  • Be helpful - think about what players need to know
  • Link related content - connect pages together

Formatting Tips

Every page should start with this structure:

---
title: "Your Page Title"
description: "Brief description for search results"
---

# Your Page Title

Your content here...

## Main Sections
Use ## for major sections

### Subsections  
Use ### for smaller sections

Using Tables

Great for stats, recipes, and structured data:

| Item | Level | Damage |
|------|-------|--------|
| Iron Sword | 10 | 25 |
| Steel Sword | 20 | 45 |

Link to other wiki pages:

[Iron Ore](/docs/resources/individual/iron_ore)
[Mining Skill](/docs/skills/individual/mining)

Mark Pages as Verified (lastVerified)

We now support a verification badge to indicate that a page has been recently reviewed by a human contributor.

What it does

  • When you add lastVerified to the page frontmatter, a checkmark icon appears next to the page title.
  • Hovering the icon shows a tooltip like “Verified on YYYY-MM-DD”.

When to use it

  • After you have reviewed the page for accuracy against the current game version or patch.
  • After updating content that was previously outdated or incomplete.
  • Use ISO date format: YYYY-MM-DD (e.g., 2025-08-10).

How to add it

Add lastVerified to the frontmatter at the top of the file:

---
title: "Your Page Title"
description: "Brief description for search results"
keywords: [tag1, tag2]
lastVerified: 2025-08-10
---

That’s it — the page will display a green check icon next to the title.

Page Organization

Our wiki is organized into these main sections:

  • Getting Started - New player guides
  • Skills - All 15 skills with guides and recipes
  • Items - Weapons, armor, tools, and consumables
  • Resources - Raw materials and crafting components
  • Map - Locations, areas, and where to find things
  • Enemies - Monster guides and combat strategies

Community Guidelines

Be Respectful

  • Use friendly, helpful language
  • Welcome different playstyles and strategies
  • Provide constructive feedback

Collaborate Well

  • Write clear descriptions in your contributions
  • Respond to feedback positively
  • Help other contributors when you can

Advanced Contributing

Local Development (Optional)

If you want to preview changes on your computer:

  1. Fork the repository on GitHub
  2. Clone it to your computer
  3. Install dependencies: npm install
  4. Run locally: npm run dev
  5. View at http://localhost:3000

File Structure

Content is organized like this:

contents/docs/
├── skills/individual/           # Individual skill pages
├── items/individual/            # Individual item pages  
├── resources/individual/        # Individual resource pages
├── map/individual/              # Individual location pages
└── enemies/individual/          # Individual enemy pages

Recognition

All contributors are recognized through:

  • Git history showing your contributions
  • GitHub profile linked to your changes
  • Community appreciation for your help

📞 Need Help?

Getting Started

  • Review existing pages for examples
  • Start with small edits to get familiar
  • Don't worry about making mistakes - we can fix them!

Questions?

  • Use "Give Feedback" on this page for questions
  • Check out existing issues on GitHub
  • Look at recent contributions for examples

Why Contribute?

The Stepcraft Wiki is a community-driven project. Every contribution helps:

  • New players learn the game faster
  • Experienced players discover new strategies
  • Everyone have access to accurate, up-to-date information
  • The community grow and thrive together

Your knowledge and experience make this wiki valuable for everyone!

Ready to Start?

  1. Find a page you'd like to improve
  2. Click "Edit Page" in the sidebar
  3. Make your changes
  4. Submit and become part of the community!

Thank you for helping make the Stepcraft Wiki better for everyone! 🎉