+
+# neoBeta
+This is a static CMS (content management system) made with eleventy for Minecraft mods.
+
+## Why?
+Because I love beta Minecraft mods, plugins and texture-packs! And I'm fascinated with static websites that do not juice the user's CPU. Also, I need to spend my free time with something...
+
+## TODO
+ - [ ] Listing projects in the artist page.
+ - [ ] Building a single-file repo index for clients to work with ([like what F-Droid does](https://f-droid.org/docs/Setup_an_F-Droid_App_Repo/))
+
+## Project structure
+New projects can be added to `/src/project` and need to follow a specific structure for proper recognition:
+
+```graphql
+/src/projects/exampleproject/*
+ ├─ index.md - # The text text content for the project page.
+ ├─ index.json - # Project metadata.
+ ├─ logo.png - # Project logo, can be defined to have a different name in the metadata.
+ └─ docs/* - # Documentation files, will automatically pick up.
+ ├─ install.md - # Example documentation page for installing the plugin.
+ ├─ uninstall.md - # And for uninstalling.
+ ├─ upgrade.md - # And for upgrading.
+ └─ manage_players.md - # And for managing players.
+```
+
+Files used in the project page can be added to it's directory and referenced relatively to the current working dir.
+
+## Project metadata
+### Required metadata fields
+ - *name* - project name.
+ - *subtitle* - project's brief description.
+ - *author* - your author name, must be consistent across all your submissions.
+ - *tags* - whether your project is a plugin or mod.
+
+### Optional metadata fields
+ - *images* - lists of image files names or URLs that will appear in the project page.
+ - *logo* - your logo file name or URL.
+ - *gameVersions* - taget Minecraft versions.
+ - *gameLoaders* - supported modloaders.
+
+### Releases metadata
+ - *releasesType* - wheter your project uses `local` releases or `github`.
+
+#### For local releases:
+ - *releases* - a list of relases labels and links.
+ - *name* - name of the release.
+ - *version* - version of the release.
+ - *gameVersions* - taget Minecraft versions (overrides default value).
+ - *gameLoaders* - supported modloaders (overrides default value).
+ - *downloads* - list of download links for this release.
+
+#### For GitHub releases:
+ - *githubRepoOwner* - username of the repo owner.
+ - *githubReponame* - name of the repository.
+
+Example index.json for a project:
+```json
+{
+ "name": "Ghosts 'n Stuff",
+ "subtitle": "Miscellaneous additions to your Minecraft server.",
+ "author": "tenkuma",
+ "downloadLink": "https://modrinth.com/plugin/ghosts/versions",
+ "images": ["anti-spam.png", "rainbow-chat.png", "skibidi-blocker.png"],
+ "logo": "logo.png",
+ "tags": ["plugin"],
+ "links": {
+ "GitHub": "https://github.com/adrianvic/ghostsandstuff",
+ "Disroot Git": "https://git.disroot.org/adrianvictor/ghostsandstuff"
+ },
+ "docs": {
+ "Installation" : "docs/installation"
+ },
+ "releaseType": "github or local",
+ "githubRepoOwner": "adrianvic",
+ "githubRepoName": "ghostsandstuff",
+ "gameLoaders": ["Craftbukkit"]
+ "releases": [
+ {
+ "name": "The first release.",
+ "version": "1.0.0",
+ "gameVersions": ["b1.7.3"],
+ "downloads": {
+ "GitHub": "https://example.com",
+ "Modrinth": "https://modrinth.com"
+ }
+ }
+ ]
+}
+```
+
+## Authors structure
+The structure for adding new author pages is mostly like the one for project pages:
+
+```graphql
+/src/authors/exampleauthor/*
+ ├─ index.md - # The text text content for the author page (bio).
+ ├─ index.json - # Author metadata.
+ └─ logo.png - # Author logo, can be defined to have a different name in the metadata.
+```
+
+The metadata is the same as the projects, however stripped down. The only values are `name`, `subtitle`, `logo` and `images`.
+
+## GitHub API integration
+neoBeta can log into a GitHub account using oAuth, this is used to automatically fetch project releases from a GitHub repository. This is needed because GitHub's API has a limit of 60 requests for users that are not authenticated.
+
+Beforing using this integration you need to populate the enviroment variables `GITHUB_CLIENT_ID` and `GITHUB_CLIENT_SECRET` with your own oAuth information, and run `gen-github-token.cjs`. A web server will be started locally (default port is `9876`), redirecting you to GitHub's oAuth screen, after logging in the script will populate `GITHUB_ACCESS_TOKEN` to your `.env`. You can set `GITHUB_ACCESS_TOKEN` directly if you have one.
+
+## Search
+Search is provided statically by [elasticlunr](http://elasticlunr.com/). The search index is compiled every time neoBeta is built. From my searches I'm confident elasticlunr will be enough for searching the project base for a sufficient period of time, if it ever get unrealistically heavy to the end-user other solutions will be explored.
+
+## Contributing
+### Adding new projects
+> [!NOTE]
+> I know it's quirky to download neoBeta's whole codebase to add projects, that's why I'll be looking into splitting the projects into a separate repo.
+
+neoBeta is intended to be crowd-sourced, so you can clone our repo, add your plugin page with the ''correct metadata'' and make a merge request. Be sure that you have the necessary rights to upload the project or proper authorization of the creator, open-source projects are better in that matter.
+
+You can also open an issue or send me an [e-mail](mailto:adrianvictor+neobeta@disroot.org) with your project info, or a link for a place with relevant info so I can add your project to our database.
+
+### With code
+Feel free to submit your contributions to this repo ^^
diff --git a/_includes/docs.njk b/_includes/docs.njk
deleted file mode 100644
index e78c540..0000000
--- a/_includes/docs.njk
+++ /dev/null
@@ -1,10 +0,0 @@
----
-layout: skeleton.njk
----
-You are seeing the documentation for: {{ projectData.fileSlug }}
-
- Adrian Victor, 2025 (Unlicense)
-Images
-
-
- 
-
- Aboukkit
-
- by tenkuma
-
-
A simple way to add custom commands with custom responses to your server.
-
-
- 
-
- Ghosts 'n Stuff
-
- by tenkuma
-
-
Miscellaneous additions to your Minecraft server.
-
-
- 
-
- tenkuma's Library
-
- by tenkuma
-
-
Library to support my other plugins. Does nothing on it's own.
-
-
- 
-
- The Devil Within
-
- by tenkuma
-
-
Adds enchanting to Minecraft Beta. Supports balancing through curses.
-
-
- 
-
- TimeKeeper
-
- by tenkuma
-
-
Syncs real world time with your Minecraft server time.
-
- A bear doing things on the internet.
-Images
-
-
- 
-
- I'm tenkuma. A bear, dreamer and sometimes developer.
-You can find more about me on my website.
- -neoBeta is an open-source content management system. There are various ways you can put your plugin/mod on our catalog:
-
-
- "name": "Ghosts 'n Stuff""subtitle": "Miscellaneous additions to your server.""author": "tenkuma""tags": ["plugin", "mod"]Please fill as many fields as possible.
-"downloadLink": "https://example.com""images": "["image1.png", "image2.png", "image3.png"]""logo": "logo.png"{
- "name": "Ghosts 'n Stuff",
- "subtitle": "Miscellaneous additions to your server.",
- "author": "tenkuma",
- "downloadLink": "https://example.com",
- "images": "["image1.png", "image2.png", "image3.png"]",
- "logo": "logo.png",
- "tags": ["plugin", "mod"]
-}
-We didn't find what you are looking for...
- -"If only the clockworks could speak
I wouldn't be so alone"
This website is the place for Minecraft plugins, made with users and developers in mind. neobeta is open-source, you can find out how the website is made in our GitHub repository (spoiler: there's some real magic going on).
-Our catalog is made by developers and community, you can get involved by following the tutorial linked here.
-
-
- Aboukkit
-by tenkuma
-
-
-
- 2025-10-27: Website redesign!
Yaaay! neoBeta got a stylish redesign.
-
- by tenkuma
-A simple way to add custom commands with custom responses to your server.
-
This plugin adds a simple way to add custom commands that will respond users with predefined messages from config.yml. It supports Minecraft's color coding (use & instead of §) and placeholders for player/server info (TODO).
These default commands need to be configured.
-First of all: run the server with the plugin for the first time, so config.yml is generated.
Follow the structure that the template shows in your config.yml. Then use a file explorer to open the plugin's JAR file and edit plugin.yml, you can copy a command entry and fill all the fields (be careful with indentation, YML does not support TAB).
I made this plugin because I have a server for version b1.7.3 and I wanted to add a /about command to give credit to the server founders and link to our website. So I made this that I will use every time I need a simple 'wall of text' command.
-I don't see why I would build this for latest versions, I guess there are already better solutions. I made this just because of the lack of plugins for Minecraft beta.
- - -
-
- by tenkuma
-Adds enchanting to Minecraft Beta. Supports balancing through curses.
-This plugin is a remake of GoldEnchant. -This plugin depends on tenkumaLib.
-Have you ever wanted to have enchantments in your beta server? This is the plugin you want.
-To enchant a armor piece you need to interact to a diamond block with a diamond armor piece in your hand.
-All of those enchantments will not take effect if the damage exceeds the player's HP. An armor get cursed if it's durability is below 30%. Spooky bad stuff will happen if your armor is cursed :D
-Prevents fall damage.
-If the player has a full-set of enchanted armor the condition of the damage being taken if it's greater than the player's HP is ignored, also the player gets immune to contact damage (cactus), lava damage and lava damage.
-Everything is explained in the config file's comments, in case it changes.
- - -You are seeing the documentation for:
-
- plugin folder.After following these steps the plugin should appear in the plugin list when you turn the server on.
- -
-
- by tenkuma
-Miscellaneous additions to your Minecraft server.
-Images
-
-
- 
-
- 
-
- 2 links.
-1 documentaion files.
-This plugins was made to use stuff from my library that would not fit into any plugin (or not in the way presented here) that has a lot (WIP) of random stuff. Everything should be togglable in the config.
by tenkuma
-Fly with a chicken!
-Seems like we don't have a description for this project.
-"If only the clockworks could speak
I wouldn't be so alone"
-
- by tenkuma
-Force your players to refrigerate their food by rotting food in unrefrigerated chests!
-
teFreezer is a fork of Freezer by outadoc, logo by malcolmriley.
-This plugins purpose is to force people in your server to refrigerate their food by placing a cold block around their chest with the food. In case there is no cold block around the chest, it will turn the food into a rotted item.
-In the config.yml you can set these values:
I have forked this plugin because I was really anoyed by the original plugin that broadcasts the message to the whole server once anyone let food rot and the lack of a configuration file.
- - -
-
- by tenkuma
-Library to support my other plugins. Does nothing on it's own.
-This is a dependency for my other projects. This does not do anything on it's own.
-You may think that installing two plugins instead of one is installing unecessary bloat that is useless. But it's not, libraries hold code that is common to more than one project, so you avoid having the same code repeated twice or more in your server. Also it's easier for the developer that has to improve only a single codebase to improve all the rest of the dependants.
- - -
-
- by tenkuma
-Syncs real world time with your Minecraft server time.
-This is a plugin for Minecraft beta that syncs the real world time with your in-game time. Logo by malcolmriley.
-It will calculate and change the game time every second (that's 20 ticks and can be changed in the config), it will use your computer's timezone as default if the config timezone value does not exist.
I am not sure if this plugin has any significant performance hit, it runs code every few ticks (you can in/decrease the frequency in the config) and that is not the best approach for doing this, but it's the only that works in beta. Using it with ticksBetweenUpdate: 1 does not seem to change the performance in any way. The specifications for the computer used for the tests:
Host: 83AF IdeaPad 1 14IAU7
-CPU: 12th Gen Intel i5-1235U (12) @ 1.300GHz
-GPU: Intel Alder Lake-UP3 GT2 [Iris Xe Graphics]
-Memory: 10097MiB / 15709MiB
-Welcome to neoBeta's search, here you can search through our whole database of plugins, mods and authors. You may want to filter out the results using the dropdown menu below. The search is done on your device using elasticlunr.
- -${doc.image ? `` : ''} ${doc.title}${doc.author ? ` by ${doc.author}` : ''}
${doc.subtitle}
-You are seeing the documentation for: {{ projectData.fileSlug }}
+
+
+ {% if projectData.data.logo %}
+ 
+ {% endif %}
{{ projectData.data.name }}
-by {{ projectData.data.author }}
+by {{ projectData.data.author }}
+ Adrian Victor, 2025 (Unlicense)
+{{ news.date }} {{ news.title }}:
+{{ news.text | safe }}
+{% endfor %} \ No newline at end of file diff --git a/_includes/project.njk b/src/_includes/project.njk similarity index 67% rename from _includes/project.njk rename to src/_includes/project.njk index 7be5f80..535d3c3 100644 --- a/_includes/project.njk +++ b/src/_includes/project.njk @@ -5,27 +5,27 @@ styles: ["project"]Here's what we found about this project:
{% if links %}{{ links | length }} links.
{{ docs | length }} documentaion files.
Images
+