add participant guide / pages route

Author: sisby-folk

fresh.gen.ts

@@ -7,6 +7,7 @@ import * as $_event_submissions from "./routes/[event]/submissions.tsx";
 import * as $_404 from "./routes/_404.tsx";
 import * as $_app from "./routes/_app.tsx";
 import * as $index from "./routes/index.tsx";
+import * as $pages_page_ from "./routes/pages/[page].tsx";
 import * as $user_user_ from "./routes/user/[user].tsx";
 
 import type { Manifest } from "$fresh/server.ts";
@@ -18,6 +19,7 @@ const manifest = {
     "./routes/_404.tsx": $_404,
     "./routes/_app.tsx": $_app,
     "./routes/index.tsx": $index,
+    "./routes/pages/[page].tsx": $pages_page_,
     "./routes/user/[user].tsx": $user_user_,
   },
   islands: {},

routes/pages/[page].tsx

@@ -0,0 +1,30 @@
+import * as path from "jsr:@std/path";
+import { RouteContext } from "$fresh/server.ts";
+import { render } from "@deno/gfm";
+
+export default async function Page(_req: Request, ctx: RouteContext) {
+  let mdFile = "";
+  try {
+    mdFile = await Deno.readTextFile(path.format({
+      dir: `${Deno.cwd()}\\static\\assets\\pages`,
+      ext: ".md",
+      name: ctx.params.page,
+    }));
+  } catch (_e) {
+    return ctx.renderNotFound();
+  }
+
+  const blocks = mdFile.split("---");
+  return (
+    <div class="flex flex-col gap-4 mb-16">
+      {blocks.map((block) => (
+        <div
+          className="card"
+          dangerouslySetInnerHTML={{
+            __html: render(block),
+          }}
+        />
+      ))}
+    </div>
+  );
+}

static/assets/pages/bcguide.md

@@ -0,0 +1,209 @@
+# BlanketCon Participant Guide
+
+---
+
+## What is BlanketCon?
+**BlanketCon is a collaborative event celebrating the art of Minecraft modding!**
+
+It features keynotes and panels hosted by members of the community, and takes place on a modded minecraft server full of booths that showcase mods and mod-related projects.
+
+Once the event is announced, mod authors and other community members can sign up to build booths for their own projects, or pitch an event they'd like to host!
+
+**For Participants, BlanketCon can be broken down into the following "phases":**
+- **Signups**: Mods, booths, and events are submitted through the ModFest Discord.
+- **Testing**: Participants collaboratively test the assembled modpack/server and fix bugs.
+- **Claiming**: Participants reserve booth space, and plan builds with the team/eachother.
+- **Building**: Participants build their booths, playtest them, and improve common areas.
+- **Showcase Weekend**: Players tour the server, award voting and stage events are held.
+
+---
+
+## Booth Submissions
+
+### Mod Submission Requirements
+- **Mods must be feature-complete when signups close** - only updates to tweak, fix, and polish existing features can be submitted after this point.
+- **Mods must have visible, up-to-date source available** - this helps the team and other participants screen mods for issues, and fix bugs and compatibility issues faster.
+- **Mods must be able to be modified to meet convention requirements** - including fixes/removals  for performance or compatibility, adventure mode restrictions, etc.
+
+### Returning Submission Considerations
+If you're submitting a project that was **shown at BlanketCon in a previous year**, please:
+- **Bring what's new to the table** - center added features/improvements in your booth!
+- **Make it fun, not an ad** - we've seen it before, so give it more than a mini-booth!
+- **Keep it sensible** - scale booth size to new content, don't just add more every year!
+
+---
+
+## What is a booth?
+
+**Booths** are themed builds that tourists can explore, that also showcase a modding project!<br/>
+Your average booth showcases a mod, and contains:
+- An entrance along a tourist path with a large sign displaying the name of the mod.
+- One collectible **Visitor Shard** ([Scattered Shards](https://modrinth.com/mod/scattered-shards)) placed at the start of the booth.
+- A general description of the mod for tourists, written on **Text Blocks** ([Glowcase](https://modrinth.com/mod/glowcase)).
+- An interactive or walk-through showcase of the mod's features, which may utilize **Item Providers** ([Glowcase](https://modrinth.com/mod/glowcase)) to allow tourists to obtain and utilize items added by the mod.
+- Up to 3 collectible **Bonus Shards** that require interacting with the mod's mechanics to obtain. Walk-through booths may have just one of these shards at their exit instead.
+- Credits for mod/booth creators, and a **Hyperlink Block** ([Glowcase](https://modrinth.com/mod/glowcase)) to the mod page.
+
+<details>
+<summary>Booth Example Screenshots</summary>
+
+### Average Booth
+
+<center>
+
+![Familiar Magic Overview](https://hackmd.io/_uploads/ByJvokWUye.jpg)
+*not every booth has to be a singular building - any cohesive space can work well.*</br>
+***familiar magic (1.21)** is comprised of small forest clearings, with a cave underneath.*
+
+![Familiar Magic Entrance](https://hackmd.io/_uploads/ryNDE1bI1g.png)
+*on-path entrance signage helps tourists find your booth, and delineates it from the path so they wont wander into it unintentionally.*
+
+![Familiar Magic Mod Description](https://hackmd.io/_uploads/BkgOByWL1g.png)
+*a mod summary explains what to expect from the booth, preventing confusion later on - this one also displays some formatting benefits of text blocks compared to signs.*
+
+![Familiar Magic Visitor Shard](https://hackmd.io/_uploads/rkG08ybUJe.png)
+*a visitor shard helps tourists track booth completion - touching this one would collect it.*
+
+![Familiar Magic Feature](https://hackmd.io/_uploads/rk2jDkZU1e.png)
+*this area tutorializes a mechanic step-by step using text blocks. the item provider allows tourists to take a copy of the flint and steel item for use.*
+
+![Familiar Magic Bonus Shard](https://hackmd.io/_uploads/Sky-K1ZU1l.png)
+*shards have a custom name, icon, and hint set by the booth author. reaching this one required using the teleport mechanic from the mod.*
+
+![Familiar Magic Credits](https://hackmd.io/_uploads/BJRn31ZU1g.png)
+*a mod page link lets tourists follow your mod if they enjoyed it, and placing it at the exit prevents the page from spoiling your booth!*
+
+</center>
+
+### Variations
+
+<center>
+
+![Dust Mansion](https://hackmd.io/_uploads/ryKPNgGDkl.png)
+*some booths use very little text, and show mod features purely experientially.*<br/>
+***Dust (Carnival)** features a dusty mansion the player can brush to clean.*
+
+![Confetti Stuff Clean Burst](https://hackmd.io/_uploads/S1iNIgGDke.png)
+*command blocks utilizing `/shard award` are used to award shards for challenges.*<br/>
+***Confetti Stuff (Carnival)** uses this for to award a shard in a cleaning race minigame.*
+
+![DBSV Overview](https://hackmd.io/_uploads/HkdoWxGPyg.jpg)
+*mods with high-depth mechanics can use course-like booths, with 'levels' per shard.*<br/>
+***Dream Burst Spirit Vector (Carnival)** is laid out as a platformer - with a basic tutorial, advanced tutorial, and a challenging level ascending a mountain.*
+
+![Vanilla Extract](https://hackmd.io/_uploads/S1CUF-Mwke.jpg)
+*booths for non-mod projects like modpacks or websites are usually walk-through, but follow the same overall structure*
+
+![Obscure Masks Minibooth](https://hackmd.io/_uploads/S1YquxfPyx.png)
+*for low-depth mods or on a time budget, a one-shard 'mini-booth' is often suitable*<br/>
+***Obscure Masks (Carnival)** uses acceptors to sell its cosmetic items, and that's it!*
+</center>
+
+### Common Areas
+
+These features ill-suit most booths, but work great pitched as collaborative builds.
+
+<center>
+
+![Cyberpunk Hangout](https://hackmd.io/_uploads/Syrc8ZGPye.png)
+*Hangout areas give tourists a break, and helps avoid group splits. (**BC23**)*
+
+![Big Top Arena](https://hackmd.io/_uploads/rJxYoxMPkx.jpg)
+*Competitive arenas like this provide repeatable fun in multiplayer. (**Carnival**)*<br/>
+*They're kept as separated attractions with their own warps, even if mod-themed.*
+
+![Cannons Ahoy Playground](https://hackmd.io/_uploads/Hk98RxGvJl.png)
+*Playgrounds and minigames add a fun non-booth activity to break things up. (**1.21**)*<br/>
+*This allows skilled builders to get creative with other submitted mods!*
+
+![Sinister Food Stand](https://hackmd.io/_uploads/Skjo3xfv1x.png)
+*Food stands help tourists get around, and add placeness to the world. (**Carnival**)*
+
+![Granbury City Limits](https://hackmd.io/_uploads/BktlsgMPyx.jpg)
+*Decorative areas like this integrate with the world lore. (**Carnival**)*<br/>
+*They contain nothing useful, but give tourists something interesting to look at.*
+
+</center>
+
+</details>
+
+---
+
+## Booth Claiming
+
+Each booth starts as a **Wool Claim** - an in-world outline that shows its location and size.<br/>
+Claims help participants collaborate on booth ideas and placement. They should:
+- Be built 50-100 blocks above the ground, to avoid colliding with the build itself later.
+- Be placed on **one side** of a tourist path - away from crossroads, spawn, and stage.
+- Contain a **vanilla sign** displaying the project name, and optionally the booth concept.
+- Indicate the booth entrance using **white wool**. Black wool can be used for back exits.
+- Indicate if they'll be taller than two storeys, or contain a large underground element.
+
+Once built, a screenshot and coordinates should be sent in for approval, whereupon the team will add a map marker, warp, and placeholders for an entrance sign and visitor shard!
+
+---
+
+## Booth Building
+
+When building your booth note that, by default, tourists **cannot**:
+- Perform suvival mode actions (break and place blocks, start fires, or place entities)
+- Interact with containers such as chests, dispensers, shulker boxes, or hoppers.
+- Interact with common decoratives such as trapdoors, flower pots, and fence gates.
+- Interact with non-input redstone components such as repeaters and comparators.
+
+However, tourists **can**:
+- Interact with wooden doors, and open trapped chests (clear these on open)
+- Interact with redstone input components such as buttons, plates, and levers.
+- Collect items from **Item Providers** and place items into **Item Acceptors** ([Glowcase](https://modrinth.com/mod/glowcase))
+
+Generally, when building your booth, try to:
+- Make your booth a real place in your chosen part of the world! Whether that's a house, a shop, a workshop, a shelter, a spooky cave, a campsite, a caravan... Work with the existing setting to give it some character! - If you need suggestions, just ask.
+- Keep your booth roughly the size it takes to show your mod - walking is boring!
+
+<details>
+<summary>Helpful Utilities</summary>
+- Glowcase Displays
+- Arealib Areas
+- Barricade
+- WE/Axiom
+- Fireblanket Spawns
+</details>
+
+---
+
+## Booth Layouts
+
+To make showcase worlds easy to navigate despite their size, we adhere to some key tricks:
+- The map can be broken into looping tour paths (or "streets") defined before claiming.
+- Every booth has its entrance along one of these tour paths, effectively giving it a "street address"
+- **Booths can share a path entrance**. To do so, the entrance should form **a smaller looping path** - as if each booth is a numbered unit at the same address.
+    - Like booths, these smaller paths should also be a "place", with clear signage.
+
+This creates a natural "checklist" of streets and booths that tourists can complete as if they're doing a paper round. Easy!
+
+---
+
+## Common Areas
+
+Your building skills don't need to be isolated to your booth!
+
+Starting from claiming, participants are welcome to collaborate with the team and eachother to improve paths and existing common areas like spawn and the stage.
+
+Once building starts, feel free to suggest and help build new (setting-friendly) common areas! Use mods where you can - food stands, lookout spots, arenas and races, minigames, or small decorative areas. Just run it by the team first to check for potential tourist issues!
+
+---
+
+## Event Submissions
+
+Stage events are a great way to share you or your team's experience with modding projects!
+
+Stage events are scheduled in 1 hour slots. You can check out [Recordings from BC23](https://www.youtube.com/playlist?list=PLt1hnuf_SwBeF1l6BAUaE7C3SOW63DOVD) for examples of previous panels and keynotes.
+
+When submitting a stage event, you should already know:
+- The title
+- Who else is hosting it
+- A rough outline of the content
+
+You'll be able to display slideshow images during your stage event via Glowcase, but keep the text nice and large! Screen blocks appear smaller in-game. Try to have your stage event completely prepared (with your slides in-game) well before launch, in case anything gets hectic.
+
+Make sure you let the team know what times during the weekend you're available to present. You'll have a time scheduled for you when your stage event is approved.