feat(music): staff upload MP3s as den music tracks

A "Music" page in both panels: an MP3 (MPEG layer III frames, 4 KB to
15 MB) becomes a den music track at once, with no restart.

- lib/custommusic.js: a custom den item made from "Jam On" (614) with a
  new `audio` column, the file's version. Its abbrName is
  CustomMusic<id>_<version>, which the content handler answers from
  data/custom-music/<id>-<version>.mp3, so a new upload is a new name and
  no game plays an old copy from its cache.
- games get it by "xdi" with no client change; players from the item
  finder, or the shop when staff tick "on sale".
- deleting it takes it from every inventory and removes the file.
- /mod/api/music and /admin/api/music: list, play, upload (name, cost,
  inShop in the query), delete; 30 uploads an hour per staff member;
  "music uploaded"/"music deleted" in the mod log.
- new permission music.upload, on the Admin role by default; a role list
  the admin has changed needs it ticked. The panels' CSP allows
  media-src 'self' for the preview players.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
BurrowdevandClaude Opus 5.5 committed 2026-10-20 15:25:27 +03:00
1 parent a77a1bcfb4
commit 2344270291
9 files changed
+517 -8

No files matched your search

+114
View File
@@ -413,6 +413,7 @@
<button role="tab" data-tab="masterpieces" aria-selected="false"><span class="icon" aria-hidden="true">&#9635;</span>Masterpieces<span id="masterpiece-count"></span></button>
<button role="tab" data-tab="items" aria-selected="false"><span class="icon" aria-hidden="true">&#10070;</span>Items</button>
<button role="tab" data-tab="wear-rules" aria-selected="false"><span class="icon" aria-hidden="true">&#9873;</span>Wear rules</button>
<button role="tab" data-tab="music" aria-selected="false"><span class="icon" aria-hidden="true">&#9835;</span>Music</button>
<button role="tab" data-tab="bans" aria-selected="false"><span class="icon" aria-hidden="true">&#8856;</span>Bans</button>
<button role="tab" data-tab="moderators" aria-selected="false"><span class="icon" aria-hidden="true">&#9733;</span>Moderators</button>
<button role="tab" data-tab="messages" aria-selected="false"><span class="icon" aria-hidden="true">&#9993;</span>Messages</button>
@@ -735,6 +736,31 @@
</section>
</div>
<div data-view="music" hidden>
<section>
<h2>Upload music</h2>
<p class="hint">An MP3 becomes a den music track at once, with no restart: players get it from the item finder (and the shop, if it is on sale) and play it in their dens like the game's own tracks. 44.1 kHz MP3s play best; 15 MB at most.</p>
<div class="actions">
<div class="action">
<h3>The track</h3>
<div class="row"><input id="music-file" type="file" accept=".mp3,audio/mpeg" aria-label="MP3 file"></div>
<div class="row" style="margin-top:8px"><input id="music-name" maxlength="40" placeholder="Name" aria-label="Name"></div>
<div class="row" style="margin-top:8px"><input id="music-cost" type="number" min="0" placeholder="Price in gems (0)" aria-label="Price in gems">
<label class="check"><input type="checkbox" id="music-shop"> On sale in the shop</label></div>
<div class="row" style="margin-top:8px"><button type="button" class="primary" id="music-upload">Upload</button></div>
</div>
</div>
<p class="status" id="music-status" role="status"></p>
</section>
<section>
<h2>Uploaded tracks</h2>
<div class="table-wrap"><table>
<thead><tr><th>Track</th><th class="num">Den item</th><th>Uploaded</th><th class="num">Size</th><th></th></tr></thead>
<tbody id="music-list"></tbody>
</table></div>
<div class="empty" id="no-music" hidden>None yet.</div>
</section>
</div>
<div data-view="items" hidden>
<section>
<h2 id="item-form-title">Make an item</h2>
@@ -2853,6 +2879,91 @@
setStatus($("control-status"), said(result), !result.ok);
});
// ---- music uploaded by staff (lib/custommusic.js): an MP3 made a den
// music track, which players get from the item finder at once
const MUSIC = "/admin/api/music";
let musicShown = "";
const musicCall = async (query, body) => {
try {
const response = await fetch(`${MUSIC}${query}`, {method: "POST", headers: {"Content-Type": "audio/mpeg"}, body});
return await response.json().catch(() => ({error: "That did not work."}));
}
catch (err) {
return {error: "The server did not answer."};
}
};
const renderMusic = data => {
const tracks = data.tracks || [];
// drawn again only when something changed: a track being listened to keeps playing
const shown = JSON.stringify(tracks);
if (shown === musicShown) {
return;
}
musicShown = shown;
$("no-music").hidden = tracks.length > 0;
$("music-list").replaceChildren(...tracks.map(track => {
const row = el("tr");
const name = el("td");
const player = el("audio");
player.controls = true;
player.preload = "none";
player.src = `${MUSIC}?play=${track.id}`;
player.style.cssText = "display:block;margin-top:6px;height:32px;max-width:260px";
name.append(el("strong", track.name), player);
const actions = el("td");
actions.append(button("Delete", async () => {
if (!confirm(`Delete "${track.name}"? It is taken from every player who has it. This cannot be undone.`)) {
return;
}
const result = await musicCall(`?delete=${track.id}`, new Uint8Array(0));
setStatus($("music-status"), result.ok || result.error || "That did not work.", !result.ok);
await loadMusic();
}, "danger"));
row.append(name, el("td", String(track.id), "num"), el("td", `${when(track.createdAt)} · ${track.createdBy}${track.inShop ? ` · on sale, ${track.cost} gems` : ""}`),
el("td", `${(track.bytes / 1048576).toFixed(1)} MB`, "num"), actions);
return row;
}));
};
const loadMusic = async () => {
try {
const response = await fetch(MUSIC);
const data = await response.json().catch(() => ({}));
if (response.ok) {
renderMusic(data);
}
}
catch (err) {
// shown again with the next refresh
}
};
// the name from the file's, until one is typed
$("music-file").addEventListener("change", () => {
const file = $("music-file").files[0];
if (file && !$("music-name").value.trim()) {
$("music-name").value = file.name.replace(/\.mp3$/i, "").replace(/[_]+/g, " ").slice(0, 40);
}
});
$("music-upload").addEventListener("click", async () => {
const file = $("music-file").files[0];
if (!file || !$("music-name").value.trim()) {
setStatus($("music-status"), file ? "Give the track a name." : "Choose an MP3 first.", true);
return;
}
$("music-upload").disabled = true;
setStatus($("music-status"), "Uploading...");
const query = `?name=${encodeURIComponent($("music-name").value.trim())}&cost=${encodeURIComponent($("music-cost").value || 0)}&inShop=${$("music-shop").checked ? 1 : 0}`;
const result = await musicCall(query, new Uint8Array(await file.arrayBuffer()));
$("music-upload").disabled = false;
setStatus($("music-status"), result.ok || result.error || "That did not work.", !result.ok);
if (result.ok) {
for (const id of ["music-file", "music-name", "music-cost"]) {
$(id).value = "";
}
$("music-shop").checked = false;
}
await loadMusic();
});
const refresh = async () => {
clearTimeout(timer);
if (!state || !state.signedIn) {
@@ -2921,6 +3032,9 @@
else if (tab === "wear-rules") {
await loadWearRules();
}
else if (tab === "music") {
await loadMusic();
}
else if (tab === "items") {
result = await api("items");
if (result.ok) {
+114
View File
@@ -478,6 +478,7 @@
<button role="tab" data-tab="review" data-needs="items.approve" aria-selected="false" hidden><span class="icon" aria-hidden="true">&#10004;</span>Review</button>
<button role="tab" data-tab="wear-rules" data-needs="items.restrict" aria-selected="false" hidden><span class="icon" aria-hidden="true">&#9873;</span>Wear rules</button>
<button role="tab" data-tab="items" data-needs="items.create" aria-selected="false" hidden><span class="icon" aria-hidden="true">&#10070;</span>Items</button>
<button role="tab" data-tab="music" data-needs="music.upload" aria-selected="false" hidden><span class="icon" aria-hidden="true">&#9835;</span>Music</button>
</nav>
<button id="sign-out" type="button">Sign out</button>
</aside>
@@ -897,6 +898,31 @@
</section>
</div>
<div data-view="music" hidden>
<section>
<h2>Upload music</h2>
<p class="hint">An MP3 becomes a den music track at once, with no restart: players get it from the item finder (and the shop, if it is on sale) and play it in their dens like the game's own tracks. 44.1 kHz MP3s play best; 15 MB at most.</p>
<div class="actions">
<div class="action">
<h3>The track</h3>
<div class="row"><input id="music-file" type="file" accept=".mp3,audio/mpeg" aria-label="MP3 file"></div>
<div class="row" style="margin-top:8px"><input id="music-name" maxlength="40" placeholder="Name" aria-label="Name"></div>
<div class="row" style="margin-top:8px"><input id="music-cost" type="number" min="0" placeholder="Price in gems (0)" aria-label="Price in gems">
<label class="check"><input type="checkbox" id="music-shop"> On sale in the shop</label></div>
<div class="row" style="margin-top:8px"><button type="button" class="primary" id="music-upload">Upload</button></div>
</div>
</div>
<p class="status" id="music-status" role="status"></p>
</section>
<section>
<h2>Uploaded tracks</h2>
<div class="table-wrap"><table>
<thead><tr><th>Track</th><th class="num">Den item</th><th>Uploaded</th><th class="num">Size</th><th></th></tr></thead>
<tbody id="music-list"></tbody>
</table></div>
<div class="empty" id="no-music" hidden>None yet.</div>
</section>
</div>
<div data-view="items" hidden>
<section>
<h2 id="item-form-title">Make an item</h2>
@@ -2733,6 +2759,91 @@
$("server-updated").textContent = `Updated ${new Date(Number(data.now || Date.now())).toLocaleTimeString()}.`;
};
// ---- music uploaded by staff (lib/custommusic.js): an MP3 made a den
// music track, which players get from the item finder at once
const MUSIC = "/mod/api/music";
let musicShown = "";
const musicCall = async (query, body) => {
try {
const response = await fetch(`${MUSIC}${query}`, {method: "POST", headers: {"Content-Type": "audio/mpeg"}, body});
return await response.json().catch(() => ({error: "That did not work."}));
}
catch (err) {
return {error: "The server did not answer."};
}
};
const renderMusic = data => {
const tracks = data.tracks || [];
// drawn again only when something changed: a track being listened to keeps playing
const shown = JSON.stringify(tracks);
if (shown === musicShown) {
return;
}
musicShown = shown;
$("no-music").hidden = tracks.length > 0;
$("music-list").replaceChildren(...tracks.map(track => {
const row = el("tr");
const name = el("td");
const player = el("audio");
player.controls = true;
player.preload = "none";
player.src = `${MUSIC}?play=${track.id}`;
player.style.cssText = "display:block;margin-top:6px;height:32px;max-width:260px";
name.append(el("strong", track.name), player);
const actions = el("td");
actions.append(button("Delete", async () => {
if (!confirm(`Delete "${track.name}"? It is taken from every player who has it. This cannot be undone.`)) {
return;
}
const result = await musicCall(`?delete=${track.id}`, new Uint8Array(0));
setStatus($("music-status"), result.ok || result.error || "That did not work.", !result.ok);
await loadMusic();
}, "danger"));
row.append(name, el("td", String(track.id), "num"), el("td", `${when(track.createdAt)} · ${track.createdBy}${track.inShop ? ` · on sale, ${track.cost} gems` : ""}`),
el("td", `${(track.bytes / 1048576).toFixed(1)} MB`, "num"), actions);
return row;
}));
};
const loadMusic = async () => {
try {
const response = await fetch(MUSIC);
const data = await response.json().catch(() => ({}));
if (response.ok) {
renderMusic(data);
}
}
catch (err) {
// shown again with the next refresh
}
};
// the name from the file's, until one is typed
$("music-file").addEventListener("change", () => {
const file = $("music-file").files[0];
if (file && !$("music-name").value.trim()) {
$("music-name").value = file.name.replace(/\.mp3$/i, "").replace(/[_]+/g, " ").slice(0, 40);
}
});
$("music-upload").addEventListener("click", async () => {
const file = $("music-file").files[0];
if (!file || !$("music-name").value.trim()) {
setStatus($("music-status"), file ? "Give the track a name." : "Choose an MP3 first.", true);
return;
}
$("music-upload").disabled = true;
setStatus($("music-status"), "Uploading...");
const query = `?name=${encodeURIComponent($("music-name").value.trim())}&cost=${encodeURIComponent($("music-cost").value || 0)}&inShop=${$("music-shop").checked ? 1 : 0}`;
const result = await musicCall(query, new Uint8Array(await file.arrayBuffer()));
$("music-upload").disabled = false;
setStatus($("music-status"), result.ok || result.error || "That did not work.", !result.ok);
if (result.ok) {
for (const id of ["music-file", "music-name", "music-cost"]) {
$(id).value = "";
}
$("music-shop").checked = false;
}
await loadMusic();
});
const refresh = async () => {
clearTimeout(timer);
if (!signedIn) {
@@ -2868,6 +2979,9 @@
else if (shown === "wear-rules") {
await loadWearRules();
}
else if (shown === "music") {
await loadMusic();
}
else if (shown === "items") {
const result = await api("items");
if (result.ok) {