Initial commit

.github/workflows/CreateRelease.yml

@@ -0,0 +1,56 @@
+name: Build and Release Party Pooper
+
+on:
+  push:
+    paths:
+      - package.json
+
+jobs:
+  build-and-release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install jq
+        run: sudo apt-get install -y jq
+
+      - name: Compare version against latest release
+        id: version-check
+        run: |
+          if git diff --exit-code HEAD^ HEAD -- package.json; then
+            echo "No changes detected in package.json"
+            exit 1
+          fi
+          NEW_VERSION=$(jq -r '.version' package.json)
+          echo "New version detected: $NEW_VERSION"
+          echo "VERSION=$NEW_VERSION" >> "$GITHUB_OUTPUT"
+    
+      - name: Set up Node.js
+        if: ${{ success() }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        if: ${{ success() }}
+        run: npm ci
+
+      - name: Build
+        if: ${{ success() }}
+        run: |
+          npm run build
+          npm run prepare
+          npm run copy-exec
+          npm run inject
+      
+      - name: Create Release
+        if: ${{ success() }}
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/PartyPooper.exe
+          tag_name: v${{ steps.version-check.outputs.VERSION }}
+          body: ${{ github.event.head_commit.message }}
+          name: Party Pooper

.gitignore

@@ -0,0 +1,4 @@
+dist/
+node_modules/
+mod/
+partyproject/

.vscode/launch.json

@@ -0,0 +1,23 @@
+{
+	// Use IntelliSense to learn about possible attributes.
+	// Hover to view descriptions of existing attributes.
+	// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+	"version": "0.2.0",
+	"configurations": [
+		{
+			"name": "Debug",
+			"program": "${workspaceFolder}/dist/partypooper.cjs",
+			"args": [
+				"./partyproject/package.nw"
+			],
+			"request": "launch",
+			"skipFiles": [
+				"<node_internals>/**"
+			],
+			"type": "node",
+			"console": "integratedTerminal",
+			"internalConsoleOptions": "neverOpen",
+			"preLaunchTask": "Debug Build"
+		}
+	]
+}

.vscode/tasks.json

@@ -0,0 +1,27 @@
+{
+	"version": "2.0.0",
+	"tasks": [
+		{
+			"type": "shell",
+			"label": "Full Build",
+			"group": {
+				"kind": "build",
+				"isDefault": true
+			},
+			"problemMatcher": [
+				"$tsc"
+			],
+			"command": "npm run clean && npm run build && npm run prepare && npm run copy-exec && npm run inject",
+			"windows": {
+				"command": "npm run clean && npm run build && npm run prepare && npm run copy-exec-win && npm run inject-win"
+			}
+		},
+		{
+			"type": "npm",
+			"script": "build-debug",
+			"group": "build",
+			"problemMatcher": [],
+			"label": "Debug Build"
+		}
+	]
+}

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Bedrockbreaker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -0,0 +1,48 @@
+# Party Pooper
+
+Modding Utility for Party Project
+
+> [!IMPORTANT]
+> Party Pooper does *not* contain of any Party Project's code or assets.
+> As far as I'm aware, Party Project does not explictly define a license on its code and assets, making it All Rights Reserved by default.
+> Download your own (free) copy of Party Project yourself from their itch page.
+
+## Usage
+
+(`PartyPooper --help`)
+```
+Usage: PartyPooper [options] <file> [destination]
+
+Modding Utility for Party Project
+
+Arguments:
+  file           path to the package.nw file
+  destination    directory to extract the assets to (default: "./partyproject")
+
+Options:
+  -V, --version  output the version number
+  -h, --help     display help for command
+```
+
+## Building from Source
+
+Requires Node.js `v20.6.0` or later.
+
+Download and install dependencies:
+```bash
+git clone https://github.com/Bedrockbreaker/PartyPooper
+cd PartyPooper
+npm install
+```
+
+After that, build the actual executable.
+
+Linux:
+```bash
+npm run build && npm run prepare && npm run copy-exec && npm run inject
+```
+
+Windows:
+```batch
+npm run build && npm run prepare && npm run copy-exec-win && npm run inject-win
+```