diff --git a/.gitignore b/.gitignore
index 6ea6a0a..998743b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
 .gradle/
 build/
 target/
+bin
diff --git a/ProjectDescription.json b/ProjectDescription.json
new file mode 100644
index 0000000..b8f4d3a
--- /dev/null
+++ b/ProjectDescription.json
@@ -0,0 +1,23 @@
+{
+  "id": "scorekeeper",
+  "title": "ScoreKeeper",
+  "description": "Paper Minecraft plugin for tracking and managing player scores.",
+  "docId": "ScoreKeeper",
+  "image": {
+    "url": "https://image.pollinations.ai/prompt/pixel%20art%20Minecraft%20server%20scoreboard%20with%20a%20glowing%20diamond%20and%20number%20counters%2C%20clean%20square%20game%20plugin%20thumbnail%2C%20no%20text",
+    "alt": "Pixel art scoreboard with a diamond for the ScoreKeeper Minecraft plugin",
+    "prompt": "Pixel art Minecraft server scoreboard with a glowing diamond and number counters, clean square game plugin thumbnail, no text",
+    "width": 1024,
+    "height": 1024,
+    "backgroundClassName": "bg-surface"
+  },
+  "url": "/projects/scorekeeper",
+  "tags": [],
+  "source": {
+    "type": "",
+    "url": ""
+  },
+  "feedback": {
+    "url": ""
+  }
+}
diff --git a/ProjectDescription.md b/ProjectDescription.md
new file mode 100644
index 0000000..c38bff5
--- /dev/null
+++ b/ProjectDescription.md
@@ -0,0 +1,16 @@
+# ScoreKeeper
+
+ScoreKeeper is a Paper Minecraft plugin for tracking player scores during server activities, events, or games. It keeps scores per player in memory and exposes commands for viewing, changing, resetting, and archiving scores.
+
+## Details
+
+- Built for Paper API 1.21.7 with Java 21 and Gradle.
+- Registers `/score-get`, `/score-add`, `/score-subtract`, `/score-reset`, and `/score-archive`.
+- Commands use the executing player when a player name is omitted.
+- Scores are currently held in memory and are not persisted when the server stops.
+- Score archiving is planned, but the current implementation reports that archiving is unavailable.
+- The project is packaged as a Java plugin with a `plugin.yml` descriptor.
+
+## Image
+
+No project image asset is included in the repository. The JSON description includes a prompt-backed image URL for a future project thumbnail.