// ==UserScript== // @name S.T.A.R.S. R.E.L.A.Y. Survey Assistant // @namespace stars-relay-oe2 // @version 1.1.0 // @description Survey/scanning assistant for Outer Empires 2. Player-controlled only. Character Lock Edition. // @author S.T.A.R.S. // @match https://game.dev.outerempires.net/* // @grant none // ==/UserScript== (function () { 'use strict' const API = 'https://oe2-api-dev.azure-api.net/v1' const IDS = { overlay: 'starsRelayOverlay', panel: 'starsRelayPanel', styles: 'starsRelayStyles', importInput: 'starsRelayImportInput' } const STORAGE = { settings: 'starsRelaySettingsV5', history: 'starsRelayHistoryV5', character: 'starsRelayLockedCharacterV110' } const SELECTORS = { explorerRow: '.SystemExplorer_Item', explorerName: '.SystemExplorer_ObjectName', scanIcon: '.ui_icon_scan' } const THEMES = { relay: { name: 'R.E.L.A.Y.', accent: '#00ff99', accentSoft: 'rgba(0,255,153,.16)', panelBg: 'rgba(0,0,0,.91)', text: '#d7fff0', muted: '#8aa89b', ready: '#ffe066', error: '#ff5555', border: 'rgba(0,255,153,.55)' }, amber: { name: 'Amber', accent: '#ffbf3c', accentSoft: 'rgba(255,191,60,.16)', panelBg: 'rgba(8,6,0,.92)', text: '#fff3d0', muted: '#b59b62', ready: '#00ff99', error: '#ff5555', border: 'rgba(255,191,60,.55)' }, blue: { name: 'Long-Range Blue', accent: '#55ccff', accentSoft: 'rgba(85,204,255,.16)', panelBg: 'rgba(0,8,14,.92)', text: '#d8f5ff', muted: '#7fa8b6', ready: '#ffe066', error: '#ff5555', border: 'rgba(85,204,255,.55)' }, red: { name: 'Rescue Red', accent: '#ff5c5c', accentSoft: 'rgba(255,92,92,.16)', panelBg: 'rgba(12,0,0,.92)', text: '#ffe2e2', muted: '#b98686', ready: '#ffe066', error: '#ff3333', border: 'rgba(255,92,92,.55)' } } const DEFAULTS = { enabled: true, compact: false, nearestFirst: true, showPanel: true, altHotkeys: false, theme: 'relay', panelX: 12, panelY: 120 } let settings = { ...DEFAULTS, ...safeJson(localStorage.getItem(STORAGE.settings), {}) } let history = [] let currentHistoryCharacterId = null let scanTargets = [] let lastData = null let apiCache = null let lastApiAt = 0 let busy = false let lastHotkey = 0 let previousCargoByPlanet = null function safeJson(text, fallback) { try { return JSON.parse(text || '') } catch { return fallback } } function saveSettings() { localStorage.setItem(STORAGE.settings, JSON.stringify(settings)) } function currentToken() { return localStorage.getItem('userToken') || '' } function tokenKey() { const token = currentToken() return token ? token.slice(0, 10) + ':' + token.slice(-24) : 'no-token' } function headers() { const token = currentToken() return { accept: 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) } } async function api(path) { const res = await fetch(`${API}${path}`, { headers: headers() }) if (!res.ok) throw new Error(`${res.status} ${path}`) return res.json() } function clean(text) { return (text || '').replace(/\s+/g, ' ').trim() } function esc(text) { return String(text).replace(/[.*+?^${}()|[\]\\]/g, '\\$&') } function cssEsc(text) { return window.CSS?.escape ? CSS.escape(String(text)) : String(text).replace(/"/g, '\\"') } function theme() { return THEMES[settings.theme] || THEMES.relay } function injectStyles() { if (document.getElementById(IDS.styles)) return const style = document.createElement('style') style.id = IDS.styles style.textContent = ` #${IDS.panel} { backdrop-filter: blur(4px); } #${IDS.panel} button { background: rgba(0,0,0,.55); color: var(--sr-text); border: 1px solid var(--sr-border); border-radius: 4px; padding: 3px 6px; font-size: 11px; margin: 2px; cursor: pointer; } #${IDS.panel} button:hover { background: var(--sr-soft); color: var(--sr-accent); } .sr-title { font-weight: 800; cursor: move; font-size: 13px; letter-spacing: .3px; } .sr-subtitle { font-size: 10px; color: var(--sr-text); margin: 2px 0 7px; line-height: 12px; opacity: .9; } .sr-summary { border: 1px solid var(--sr-border); background: var(--sr-soft); padding: 5px; border-radius: 5px; margin-bottom: 6px; color: var(--sr-text); } .sr-character { color: var(--sr-ready); font-weight: 700; margin-bottom: 6px; } .sr-section-title { color: var(--sr-text); font-weight: 700; margin: 7px 0 3px; } .sr-line { margin: 4px 0; padding: 5px; border-radius: 5px; border: 1px solid rgba(255,255,255,.12); background: rgba(0,0,0,.28); color: var(--sr-text); font-size: 11px; line-height: 14px; } .sr-line-next { border-color: var(--sr-ready); background: rgba(255,224,102,.12); } .sr-line-ready { color: var(--sr-ready); border-color: rgba(255,224,102,.5); } .sr-line-muted { color: var(--sr-muted); } .sr-history { color: var(--sr-muted); font-size: 11px; line-height: 14px; } .sr-small { font-size: 10px; color: var(--sr-muted); } .sr-divider { border: 0; border-top: 1px solid var(--sr-border); margin: 7px 0; } .sr-flag { position: fixed; font-weight: 800; line-height: 14px; background: rgba(0,0,0,.80); border: 1px solid var(--sr-accent); color: var(--sr-accent); border-radius: 4px; text-shadow: 1px 1px 2px #000; pointer-events: auto; cursor: pointer; user-select: none; white-space: nowrap; box-shadow: 0 0 6px rgba(0,0,0,.65); } .sr-flag-next { color: var(--sr-ready); border-color: var(--sr-ready); background: rgba(0,0,0,.88); } ` document.head.appendChild(style) } function applyTheme() { injectStyles() const t = theme() document.documentElement.style.setProperty('--sr-accent', t.accent) document.documentElement.style.setProperty('--sr-soft', t.accentSoft) document.documentElement.style.setProperty('--sr-panel-bg', t.panelBg) document.documentElement.style.setProperty('--sr-text', t.text) document.documentElement.style.setProperty('--sr-muted', t.muted) document.documentElement.style.setProperty('--sr-ready', t.ready) document.documentElement.style.setProperty('--sr-error', t.error) document.documentElement.style.setProperty('--sr-border', t.border) } function lockedCharacter() { const saved = safeJson(localStorage.getItem(STORAGE.character), null) if (!saved?.id) return null if (saved.tokenKey && saved.tokenKey !== tokenKey()) return null return saved } function characterLabel(character = lockedCharacter()) { if (!character?.id) return 'No character selected' return character.name ? `${character.name} [${character.id}]` : `Character [${character.id}]` } function historyKey(id = currentHistoryCharacterId) { return id ? `${STORAGE.history}:${id}` : STORAGE.history } function loadHistoryForCharacter(id) { const nextId = String(id || '') if (!nextId || currentHistoryCharacterId === nextId) return currentHistoryCharacterId = nextId history = safeJson(localStorage.getItem(historyKey(nextId)), []) previousCargoByPlanet = null } function saveHistory() { if (!currentHistoryCharacterId) return history = history.slice(-100) localStorage.setItem(historyKey(), JSON.stringify(history)) } function clearVisibleCharacterData() { apiCache = null lastData = null scanTargets = [] previousCargoByPlanet = null document.getElementById(IDS.overlay)?.replaceChildren() } function clearCharacterLock() { localStorage.removeItem(STORAGE.character) sessionStorage.removeItem(STORAGE.character) localStorage.removeItem('oe2CharacterId') currentHistoryCharacterId = null history = [] clearVisibleCharacterData() } function lockCharacter(id, name = '') { const cleanId = String(id || '').trim() if (!cleanId) return false localStorage.setItem(STORAGE.character, JSON.stringify({ id: cleanId, name: clean(name), tokenKey: tokenKey(), savedAt: Date.now() })) loadHistoryForCharacter(cleanId) clearVisibleCharacterData() return true } function clearAllHistories() { Object.keys(localStorage) .filter(key => key === STORAGE.history || key.startsWith(`${STORAGE.history}:`) || key === 'starsRelayHistory' || key === 'starsRelayHistoryV2' || key === 'starsRelayHistoryV3' || key.startsWith('starsRelayHistoryV3:') || key === 'starsRelayHistoryV4' || key.startsWith('starsRelayHistoryV4:') || key === 'starsRelayHistoryV5' || key.startsWith('starsRelayHistoryV5:') ) .forEach(key => localStorage.removeItem(key)) } async function getCharacters() { const json = await api('/characters').catch(() => null) return json?.data || [] } function characterChoiceText(list) { return list .map(c => { const id = c.characterID || c.characterId || c.id || '' const name = [ c.charFirstName, c.charLastName, c.name, c.characterName ].filter(Boolean).join(' ') return id ? `${id}${name ? ` — ${name}` : ''}` : '' }) .filter(Boolean) .join('\n') } function characterNameFromList(list, id) { const found = list.find(c => String(c.characterID || c.characterId || c.id || '') === String(id) ) if (!found) return '' return [ found.charFirstName, found.charLastName, found.name, found.characterName ].filter(Boolean).join(' ') } async function chooseRelayCharacter() { const list = await getCharacters() const choices = characterChoiceText(list) const message = [ 'S.T.A.R.S. R.E.L.A.Y.: enter the character ID to track', '', choices ? 'Available characters:' : 'No character list found.', choices ].filter(Boolean).join('\n') const entered = prompt(message) if (!entered) return false const id = entered.trim() const name = characterNameFromList(list, id) if (!lockCharacter(id, name)) return false await draw(true) return true } function getCharId() { const character = lockedCharacter() if (!character?.id) return '' loadHistoryForCharacter(character.id) return character.id } function planetFromJob(job, objectById = {}) { const id = String(job.info2 || '') if (id && objectById[id]?.name) return objectById[id].name const detail = clean(job.detail) const system = clean(job.systemName2) if (system) { const match = detail.match( new RegExp(`(${esc(system)}\\s+[IVXLCDM]+)\\s*\\(`, 'i') ) if (match) return match[1].trim() } return detail.match( /([A-Za-z0-9-]+(?:\s+[A-Za-z0-9-]+)*\s+[IVXLCDM]+)\s*\(/i )?.[1]?.trim() } function planetFromCargo(item) { const text = clean( item.resourceName || item.name || item.cargoName || '' ) return text.match(/^(.+?),\s*.+?\s*\([A-F0-9]{7}\)/i)?.[1]?.trim() } function surveyItem(item) { return item.typeC === 'Sc' || /survey/i.test(item.resourceName || '') } function getCurrentSystemName(systemJson, character) { return ( clean(systemJson?.data?.name) || clean(systemJson?.data?.systemName) || clean(character?.systemName) || clean((systemJson?.data?.systemObjects || []).find(o => o.objectType === 'Star')?.name) ) } function logCargoChanges(cargoByPlanet) { if (!previousCargoByPlanet) { previousCargoByPlanet = { ...cargoByPlanet } return } Object.entries(cargoByPlanet).forEach(([planet, amount]) => { const old = previousCargoByPlanet[planet] || 0 const delta = amount - old if (delta > 0) { history.push({ time: new Date().toLocaleTimeString(), text: `Report received: ${planet}${delta > 1 ? ` x${delta}` : ''}` }) } }) previousCargoByPlanet = { ...cargoByPlanet } saveHistory() } async function getSurveyData(force = false) { const now = Date.now() if (!force && apiCache && now - lastApiAt < 1000) { return apiCache } const characterId = getCharId() if (!characterId) { throw new Error('No R.E.L.A.Y. character selected') } const character = (await api(`/character/${characterId}`)).data const shipId = character.currentShipID const systemId = character.systemID const [jobsJson, cargoJson, systemJson] = await Promise.all([ api(`/jobs/accepted?characterId=${characterId}`), api(`/cargo/location/${shipId}?characterID=${characterId}&locationType=Sh`), systemId ? api(`/system/${systemId}`) : Promise.resolve({ data: { systemObjects: [] } }) ]) const currentSystemName = getCurrentSystemName(systemJson, character) const systemObjects = systemJson?.data?.systemObjects || [] const objectById = {} const objectIdByName = {} systemObjects.forEach(obj => { if (!obj?.systemObjectsId || !obj?.name) return objectById[String(obj.systemObjectsId)] = obj objectIdByName[obj.name] = String(obj.systemObjectsId) }) const cargoItems = [] const cargoByPlanet = {} ;(cargoJson.data || []) .filter(surveyItem) .forEach(item => { const planet = planetFromCargo(item) const objectId = item.jobSystemObjectId ? String(item.jobSystemObjectId) : '' const amount = Number(item.amount || 1) if (!planet && !objectId) return cargoItems.push({ planet, objectId, amount }) if (planet) { cargoByPlanet[planet] = (cargoByPlanet[planet] || 0) + amount } }) const groups = {} ;(jobsJson.data || []) .filter(j => /survey/i.test(j.jobType || '')) .forEach(job => { const targetObjectId = job.info2 ? String(job.info2) : '' const planet = planetFromJob(job, objectById) if (!planet && !targetObjectId) return const key = targetObjectId ? `id:${targetObjectId}` : `name:${planet}` groups[key] ??= { key, objectId: targetObjectId, planet: planet || objectById[targetObjectId]?.name || `Object ${targetObjectId}`, system: job.systemName2 || '', deliverTo: job.jobIssuedLocationName || '', needed: 0, cargo: 0, remaining: 0, credits: 0, xp: 0, jobIds: [], inCurrentSystem: false, ready: false } groups[key].needed += 1 groups[key].credits += Number(job.credits || 0) groups[key].xp += Number(job.xp || 0) groups[key].jobIds.push(job.jobID) }) Object.values(groups).forEach(group => { group.cargo = cargoItems.reduce((sum, item) => { const sameId = group.objectId && item.objectId && group.objectId === item.objectId const sameName = item.planet && group.planet && item.planet === group.planet return sum + (sameId || sameName ? item.amount : 0) }, 0) group.remaining = Math.max(group.needed - group.cargo, 0) group.ready = group.needed > 0 && group.remaining === 0 group.inCurrentSystem = !!(group.objectId && objectById[group.objectId]) || group.system === currentSystemName || !!objectIdByName[group.planet] }) const data = { characterId, characterName: characterLabel(), shipId, systemId, currentSystemName, objectById, objectIdByName, groups, cargoByPlanet } logCargoChanges(cargoByPlanet) apiCache = data lastApiAt = now lastData = data return data } function getOverlay() { let overlay = document.getElementById(IDS.overlay) if (!overlay) { overlay = document.createElement('div') overlay.id = IDS.overlay Object.assign(overlay.style, { position: 'fixed', inset: '0', pointerEvents: 'none', zIndex: '999999' }) document.body.appendChild(overlay) } return overlay } function objectName(nameEl) { return clean( nameEl.getAttribute('data-ui-tooltip')?.replace('#', '') || nameEl.childNodes[0]?.textContent || nameEl.innerText ) } function distance(item) { return Number( (item.innerText || '').match(/([\d.]+)\s*SU/i)?.[1] || 999999 ) } function visible(el) { const r = el.getBoundingClientRect() return ( r.width && r.height && r.bottom > 0 && r.top < innerHeight ) } function clickScan(scanIcon) { if (!scanIcon) return const r = scanIcon.getBoundingClientRect() const x = r.left + r.width / 2 const y = r.top + r.height / 2 scanIcon.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true, view: window, clientX: x, clientY: y, button: 0 })) apiCache = null setTimeout(() => draw(true), 350) setTimeout(() => draw(true), 1200) setTimeout(() => draw(true), 2400) } function makeFlag(id) { const flag = document.createElement('div') flag.dataset.id = id flag.className = 'sr-flag' flag.onclick = e => { e.preventDefault() e.stopPropagation() const target = scanTargets[ Number(flag.dataset.key) - 1 ] if (target) { clickScan(target.scanIcon) } } return flag } function panel() { let p = document.getElementById(IDS.panel) if (p) return p p = document.createElement('div') p.id = IDS.panel Object.assign(p.style, { position: 'fixed', left: `${settings.panelX}px`, top: `${settings.panelY}px`, zIndex: '1000000', background: 'var(--sr-panel-bg)', border: '1px solid var(--sr-border)', color: 'var(--sr-accent)', font: '12px Arial, sans-serif', padding: '8px', borderRadius: '8px', width: '350px', maxHeight: '490px', overflow: 'auto', boxShadow: '0 0 18px rgba(0,0,0,.65)' }) p.innerHTML = `