👤 NPC Tracker v1.0

🛠️ Setup Instructions for the DM

To use this tracker, you need to link it to a Google Sheet using Google Apps Script.

1. Set Up the Google Sheet:
   • Create a new Google Sheet.
   • Add two tabs at the bottom. Name the first one NPCs and the second one PCs.
   • In the PCs sheet, type PlayerName, CharacterName, and PIN as column headers to create player logins.
2. Add the Code:
   • Click Extensions > Apps Script.
   • Paste the provided database script below (replacing any existing code).
   const NPC_SHEET = "NPCs"; const PC_SHEET = "PCs"; const BACKEND_VERSION = "1.0"; const DB_TYPE = "NPC Database"; function doGet(e) { try { const ss = SpreadsheetApp.getActiveSpreadsheet(); const getSheetData = (sheetName) => { let s = ss.getSheetByName(sheetName); let arr = []; if (s) { let data = s.getDataRange().getValues(); if (data.length > 1) { let headers = data[0]; for (let i = 1; i < data.length; i++) { let obj = {}; headers.forEach((h, idx) => { let val = data[i][idx]; try { if (typeof val === 'string' && (val.startsWith('[') || val.startsWith('{'))) { obj[h] = JSON.parse(val); } else { obj[h] = val; } } catch(e) { obj[h] = val; } }); arr.push(obj); } } } return arr; }; return ContentService.createTextOutput(JSON.stringify({ dbType: DB_TYPE, backendVersion: BACKEND_VERSION, npcs: getSheetData(NPC_SHEET), pcs: getSheetData(PC_SHEET) })).setMimeType(ContentService.MimeType.JSON); } catch(err) { return ContentService.createTextOutput(JSON.stringify({error: err.toString()})).setMimeType(ContentService.MimeType.JSON); } } function doPost(e) { try { const p = JSON.parse(e.postData.contents); if (p.action === 'saveData') { const saveSheet = (sheetName, dataArray) => { let ss = SpreadsheetApp.getActiveSpreadsheet(); let s = ss.getSheetByName(sheetName); if(!s) s = ss.insertSheet(sheetName); s.clear(); if(dataArray && dataArray.length > 0) { // Collect all unique headers to ensure no missing columns let headerSet = new Set(); dataArray.forEach(item => Object.keys(item).forEach(k => headerSet.add(k))); let headers = Array.from(headerSet); let rows = [headers]; dataArray.forEach(item => { rows.push(headers.map(h => { let val = item[h]; if (val === undefined || val === null) return ""; if (typeof val === 'boolean') return val ? "TRUE" : "FALSE"; if (typeof val === 'object') return JSON.stringify(val); return val; })); }); s.getRange(1, 1, rows.length, headers.length).setValues(rows); } }; saveSheet(NPC_SHEET, p.npcs); saveSheet(PC_SHEET, p.pcs); return ContentService.createTextOutput(JSON.stringify({status: "success"})).setMimeType(ContentService.MimeType.JSON); } } catch(err) { return ContentService.createTextOutput(JSON.stringify({error: err.toString()})).setMimeType(ContentService.MimeType.JSON); } } 📋 Copy Script
   • Click the Save icon.
3. Deploy the Web App:
   • In the top right corner, click Deploy > New deployment.
   • Click the gear icon ⚙️ next to "Select type" and choose Web app.
   • Under "Execute as", select Me.
   • Under "Who has access", select Anyone.
   • Click Deploy and authorize permissions.
4. Link the App:
   • Copy the Web app URL provided by Google.
   • Paste it into the input box above!