j.foucher
48d1543329
- Bulk rename Category/ClassGroup strings to ASTERION|PS_AI_ConvAgent|... and ASTERION|PS_AI_Behavior|... (284 occurrences, 24 files) so functions/properties/components group cleanly in Blueprint menus - Move bAutoStartBehavior from AIController to PersonalityComponent so the same AIController class can drive multiple NPC archetypes with per-instance scripted-mode override - Add PowerPoint user documentation for both plugins in Docs/ with generator scripts Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
692 lines
54 KiB
JavaScript
692 lines
54 KiB
JavaScript
// PS_AI_Behavior User Documentation Generator
|
||
// Palette: Warm Terracotta (terracotta #B85042, sand #E7E8D1, sage #A7BEAE)
|
||
|
||
const pptxgen = require("pptxgenjs");
|
||
const pres = new pptxgen();
|
||
|
||
pres.layout = "LAYOUT_WIDE"; // 13.333 x 7.5 inch
|
||
|
||
// ─── Color Palette ─────────────────────────────────
|
||
const TERRA = "B85042";
|
||
const TERRA_D = "7A3229";
|
||
const SAND = "E7E8D1";
|
||
const SAND_LT = "F5F5EA";
|
||
const SAGE = "A7BEAE";
|
||
const SAGE_D = "5F7566";
|
||
const WHITE = "FFFFFF";
|
||
const CHARCOAL = "2E2A26";
|
||
const GOLD = "D4A84B";
|
||
|
||
// ─── Font ──────────────────────────────────────────
|
||
const FONT_H = "Calibri";
|
||
const FONT_B = "Calibri";
|
||
|
||
// ─── Master slide backgrounds ──────────────────────
|
||
pres.defineSlideMaster({
|
||
title: "CONTENT",
|
||
background: { color: SAND_LT },
|
||
objects: [
|
||
{ rect: { x: 0, y: 0, w: 13.333, h: 0.35, fill: { color: TERRA } } },
|
||
{ rect: { x: 0, y: 7.15, w: 13.333, h: 0.35, fill: { color: TERRA } } },
|
||
{ text: {
|
||
text: "PS_AI_Behavior — User Documentation",
|
||
options: { x: 0.3, y: 7.18, w: 8, h: 0.3, fontSize: 10, color: SAND, fontFace: FONT_B }
|
||
} },
|
||
{ text: {
|
||
text: "ASTERION",
|
||
options: { x: 11.5, y: 7.18, w: 1.5, h: 0.3, fontSize: 10, color: SAND, fontFace: FONT_B, align: "right", bold: true }
|
||
} },
|
||
],
|
||
});
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 1 — TITLE
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
let s = pres.addSlide();
|
||
s.background = { color: TERRA };
|
||
s.addShape(pres.ShapeType.rect, { x: 0, y: 3.3, w: 13.333, h: 0.05, fill: { color: GOLD } });
|
||
s.addText("PS_AI_Behavior", { x: 0.6, y: 2.2, w: 12, h: 1.2, fontSize: 60, bold: true, color: WHITE, fontFace: FONT_H });
|
||
s.addText("Personality-Driven NPC AI for Unreal Engine", { x: 0.6, y: 3.5, w: 12, h: 0.6, fontSize: 22, color: SAND, fontFace: FONT_B, italic: true });
|
||
s.addText("User Documentation", { x: 0.6, y: 4.4, w: 12, h: 0.5, fontSize: 18, color: SAND, fontFace: FONT_B });
|
||
s.addText("Civilians • Enemies • Protectors • Cover System • Splines", { x: 0.6, y: 5.2, w: 12, h: 0.4, fontSize: 14, color: SAND, fontFace: FONT_B });
|
||
s.addText("ASTERION • 2026", { x: 0.6, y: 6.6, w: 12, h: 0.4, fontSize: 12, color: SAND, fontFace: FONT_B });
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 2 — OVERVIEW
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("Plugin Overview", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 36, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
|
||
s.addText("What it does", { x: 0.5, y: 1.7, w: 6, h: 0.4, fontSize: 18, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addText([
|
||
{ text: "Personality-driven AI for NPCs", options: { bullet: true, fontSize: 14 } },
|
||
{ text: "Three archetypes: Civilian, Enemy, Protector", options: { bullet: true, fontSize: 14 } },
|
||
{ text: "Trait-based reactions: Courage, Aggressivity, Caution", options: { bullet: true, fontSize: 14 } },
|
||
{ text: "Tactical combat + cover system + EQS", options: { bullet: true, fontSize: 14 } },
|
||
{ text: "Spline-based patrol networks", options: { bullet: true, fontSize: 14 } },
|
||
{ text: "Interface-driven — no Pawn class dependency", options: { bullet: true, fontSize: 14 } },
|
||
], { x: 0.5, y: 2.1, w: 6, h: 3, color: CHARCOAL, fontFace: FONT_B, paraSpaceAfter: 8 });
|
||
|
||
s.addShape(pres.ShapeType.roundRect, { x: 7, y: 1.7, w: 5.8, h: 4.8, fill: { color: TERRA }, rectRadius: 0.1 });
|
||
s.addText("Primary Use Case", { x: 7.2, y: 1.9, w: 5.4, h: 0.4, fontSize: 16, bold: true, color: GOLD, fontFace: FONT_H });
|
||
s.addText("Populate your world with intelligent NPCs that perceive threats, evaluate risk based on personality, and respond appropriately — civilians flee from gunfire, enemies engage in tactical combat, protectors defend civilians.", {
|
||
x: 7.2, y: 2.4, w: 5.4, h: 1.7, fontSize: 13, color: SAND, fontFace: FONT_B, italic: true
|
||
});
|
||
s.addText("Key Differentiators", { x: 7.2, y: 4.2, w: 5.4, h: 0.4, fontSize: 16, bold: true, color: GOLD, fontFace: FONT_H });
|
||
s.addText([
|
||
{ text: "Data-driven personality profiles", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "Built-in cover cycle state machine", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "Spline network with junction detection", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "Gaze bridge to ConvAgent (reflection)", options: { bullet: true, fontSize: 12 } },
|
||
], { x: 7.2, y: 4.7, w: 5.4, h: 1.7, color: SAND, fontFace: FONT_B, paraSpaceAfter: 4 });
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 3 — CORE ARCHITECTURE
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("Core Architecture", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 36, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
|
||
s.addText("The plugin is built around four concepts:", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
const pillars = [
|
||
{ title: "Interface", subtitle: "IPS_AI_Behavior_Interface", desc: "Implemented on host project Pawns. Zero compile dependency — identity, team, combat, movement." },
|
||
{ title: "NPC Type", subtitle: "Civilian / Enemy / Protector", desc: "Determines team, spline access, default tree. Enemies can be disguised (hostile=false)." },
|
||
{ title: "State", subtitle: "Behavior State enum", desc: "Idle, Patrol, Alerted, Combat, Fleeing, TakingCover, Dead, Scripted. Written to Blackboard." },
|
||
{ title: "Profile", subtitle: "PersonalityProfile data asset", desc: "Traits, thresholds, target priority, speed per state, default BT." },
|
||
];
|
||
pillars.forEach((p, i) => {
|
||
const col = i % 2;
|
||
const row = Math.floor(i / 2);
|
||
const x = 0.5 + col * 6.3;
|
||
const y = 2.2 + row * 2.3;
|
||
s.addShape(pres.ShapeType.roundRect, { x: x, y: y, w: 6.0, h: 2.1, fill: { color: TERRA }, rectRadius: 0.1 });
|
||
s.addText(p.title, { x: x + 0.2, y: y + 0.15, w: 5.6, h: 0.45, fontSize: 20, bold: true, color: GOLD, fontFace: FONT_H });
|
||
s.addText(p.subtitle, { x: x + 0.2, y: y + 0.6, w: 5.6, h: 0.35, fontSize: 12, color: SAND, italic: true, fontFace: "Consolas" });
|
||
s.addText(p.desc, { x: x + 0.2, y: y + 1.0, w: 5.6, h: 1.0, fontSize: 12, color: SAND, fontFace: FONT_B });
|
||
});
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 4 — NPC TYPES & TEAM ID
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("NPC Types & TeamId", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 36, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("Identity drives perception, targeting, and access control.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
// Three NPC cards
|
||
const npcs = [
|
||
{ name: "CIVILIAN", color: SAGE, id: "0x00", desc: "Non-hostile. Flees. Allied with Protector." },
|
||
{ name: "ENEMY", color: TERRA, id: "0x10", desc: "Hostile. Tactical combat. Can be disguised." },
|
||
{ name: "PROTECTOR", color: SAGE_D, id: "0x20", desc: "Police / guard. Defends Civilians." },
|
||
];
|
||
npcs.forEach((n, i) => {
|
||
const x = 0.5 + i * 4.3;
|
||
s.addShape(pres.ShapeType.roundRect, { x: x, y: 2.15, w: 4.0, h: 2.2, fill: { color: n.color }, rectRadius: 0.1 });
|
||
s.addText(n.name, { x: x + 0.2, y: 2.3, w: 3.6, h: 0.5, fontSize: 22, bold: true, color: WHITE, align: "center", fontFace: FONT_H });
|
||
s.addText(`TeamId = ${n.id}`, { x: x + 0.2, y: 2.85, w: 3.6, h: 0.35, fontSize: 14, color: WHITE, align: "center", italic: true, fontFace: "Consolas" });
|
||
s.addText(n.desc, { x: x + 0.2, y: 3.3, w: 3.6, h: 0.95, fontSize: 12, color: WHITE, align: "center", fontFace: FONT_B });
|
||
});
|
||
|
||
// TeamId encoding
|
||
s.addShape(pres.ShapeType.roundRect, { x: 0.5, y: 4.6, w: 12.3, h: 2.3, fill: { color: TERRA }, rectRadius: 0.1 });
|
||
s.addText("TeamId Encoding", { x: 0.7, y: 4.7, w: 12, h: 0.4, fontSize: 16, bold: true, color: GOLD, fontFace: FONT_H });
|
||
s.addText("uint8 = (high nibble: NPCType) | (low nibble: Faction 0-15)", { x: 0.7, y: 5.1, w: 12, h: 0.3, fontSize: 13, color: SAND, italic: true, fontFace: "Consolas" });
|
||
|
||
s.addText([
|
||
{ text: "Same type + same faction → Friendly (allies)", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "Same type + different faction → Hostile (rival gangs)", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "Civilian ↔ Protector → always Friendly", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "Everything else → Hostile", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "Disguised Enemy (hostile=false) → TeamId 0x01 (civilian disguise)", options: { bullet: true, fontSize: 12 } },
|
||
], { x: 0.7, y: 5.45, w: 12, h: 1.4, color: SAND, fontFace: FONT_B, paraSpaceAfter: 3 });
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 5 — BEHAVIOR STATES
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("Behavior States", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 36, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("Enum written to Blackboard, drives BT branching.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
const states = [
|
||
{ name: "Idle", desc: "Resting / waiting. Proximity gaze active." },
|
||
{ name: "Patrol", desc: "Wandering on waypoints or splines." },
|
||
{ name: "Alerted", desc: "Suspicious, heightened awareness." },
|
||
{ name: "Combat", desc: "Engaged with a threat, attacking." },
|
||
{ name: "Fleeing", desc: "Running away from danger." },
|
||
{ name: "TakingCover", desc: "Behind tactical cover during combat." },
|
||
{ name: "Dead", desc: "NPC deceased, all systems shut down." },
|
||
{ name: "Scripted", desc: "Manual override (conversations, cinematics)." },
|
||
];
|
||
states.forEach((state, i) => {
|
||
const col = i % 4;
|
||
const row = Math.floor(i / 4);
|
||
const x = 0.5 + col * 3.15;
|
||
const y = 2.2 + row * 2.3;
|
||
s.addShape(pres.ShapeType.roundRect, { x: x, y: y, w: 2.95, h: 2.1, fill: { color: SAND }, line: { color: TERRA, width: 1 }, rectRadius: 0.08 });
|
||
s.addShape(pres.ShapeType.rect, { x: x, y: y, w: 2.95, h: 0.55, fill: { color: TERRA } });
|
||
s.addText(state.name, { x: x, y: y + 0.05, w: 2.95, h: 0.5, fontSize: 16, bold: true, color: WHITE, align: "center", valign: "middle", fontFace: FONT_H });
|
||
s.addText(state.desc, { x: x + 0.15, y: y + 0.7, w: 2.65, h: 1.3, fontSize: 11, color: CHARCOAL, valign: "top", fontFace: FONT_B });
|
||
});
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 6 — AI CONTROLLER
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("AI Controller", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 36, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("APS_AI_Behavior_AIController — the central orchestrator.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
s.addText("Auto-setup on Possession", { x: 0.5, y: 2.15, w: 6, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addText([
|
||
{ text: "Discovers PersonalityComponent on Pawn", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "Computes TeamId from NPCType + Faction", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "Initializes Blackboard with required keys", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "Binds gaze bridge to ConvAgent (if present)", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "Starts BT (unless bAutoStartBehavior = false)", options: { bullet: true, fontSize: 12 } },
|
||
], { x: 0.5, y: 2.55, w: 6, h: 2.5, color: CHARCOAL, fontFace: FONT_B, paraSpaceAfter: 4 });
|
||
|
||
s.addText("Key Methods", { x: 7, y: 2.15, w: 6, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addText([
|
||
{ text: "StartBehavior() / StopBehavior()", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "SetBehaviorState() / GetBehaviorState()", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "SetTeamId() — runtime team change", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "GetBehaviorPerception()", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "GetPersonalityComponent()", options: { bullet: true, fontSize: 12 } },
|
||
], { x: 7, y: 2.55, w: 6, h: 2.5, color: CHARCOAL, fontFace: FONT_B, paraSpaceAfter: 4 });
|
||
|
||
s.addShape(pres.ShapeType.roundRect, { x: 0.5, y: 5.2, w: 12.3, h: 1.8, fill: { color: TERRA }, rectRadius: 0.1 });
|
||
s.addText("Gaze Bridge (Proximity)", { x: 0.7, y: 5.3, w: 12, h: 0.35, fontSize: 14, bold: true, color: GOLD, fontFace: FONT_H });
|
||
s.addText("Reflection-based integration with PS_AI_ConvAgent. During Idle/Patrol, NPC glances at nearby actors within GazeProximityRadius. Configurable duration and cooldown. Auto-pauses during active conversations.", {
|
||
x: 0.7, y: 5.7, w: 12, h: 1.25, fontSize: 12, color: SAND, italic: true, fontFace: FONT_B
|
||
});
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 7 — PERSONALITY COMPONENT
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("Personality Component", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 36, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("Runtime traits & state reactions for the NPC.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
// Traits triangle
|
||
s.addText("The Three Traits", { x: 0.5, y: 2.15, w: 6, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
|
||
const traits = [
|
||
{ name: "Courage", desc: "0 = coward, 1 = fearless", effect: "Gates flee threshold & cover advancement", color: "C9463A" },
|
||
{ name: "Aggressivity", desc: "0 = peaceful, 1 = violent", effect: "Drives attack threshold, combat/cover cycle", color: "D4803A" },
|
||
{ name: "Caution", desc: "0 = reckless, 1 = prudent", effect: "Flee threshold, cover duration, spline threat", color: "7C9D7B" },
|
||
];
|
||
traits.forEach((t, i) => {
|
||
const y = 2.6 + i * 0.95;
|
||
s.addShape(pres.ShapeType.roundRect, { x: 0.5, y: y, w: 1.8, h: 0.8, fill: { color: t.color }, rectRadius: 0.08 });
|
||
s.addText(t.name, { x: 0.5, y: y + 0.1, w: 1.8, h: 0.3, fontSize: 14, bold: true, color: WHITE, align: "center", fontFace: FONT_H });
|
||
s.addText(t.desc, { x: 0.5, y: y + 0.45, w: 1.8, h: 0.3, fontSize: 10, color: WHITE, align: "center", italic: true, fontFace: FONT_B });
|
||
s.addText(t.effect, { x: 2.4, y: y + 0.15, w: 4.2, h: 0.6, fontSize: 12, color: CHARCOAL, valign: "middle", fontFace: FONT_B });
|
||
});
|
||
|
||
s.addText("Properties & Events", { x: 7, y: 2.15, w: 6, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addText([
|
||
{ text: "Profile — PersonalityProfile DataAsset", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "bAutoStartBehavior — per-NPC override", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "RuntimeTraits — editable at runtime", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "PerceivedThreatLevel — replicated", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "CurrentState — replicated with OnRep", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "EvaluateReaction() / ApplyReaction()", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "ModifyTrait() / GetTrait()", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "ForceState() — scripting override", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "OnBehaviorStateChanged delegate", options: { bullet: true, fontSize: 12 } },
|
||
], { x: 7, y: 2.55, w: 6, h: 4.5, color: CHARCOAL, fontFace: FONT_B, paraSpaceAfter: 3 });
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 8 — PERSONALITY PROFILE
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("PersonalityProfile DataAsset", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 32, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("The behavioral recipe — one profile per NPC archetype.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
const profileCats = [
|
||
{ title: "Identity", items: ["ProfileName", "NPCType", "Faction (0-15)"] },
|
||
{ title: "Traits", items: ["Courage (0-1)", "Aggressivity (0-1)", "Caution (0-1)"] },
|
||
{ title: "Thresholds", items: ["FleeThreshold", "AttackThreshold", "AlertThreshold", "ThreatDecayRate"] },
|
||
{ title: "Combat", items: ["TargetPriority[]", "MinAttackRange / MaxAttackRange", "CombatCoverCycleDuration"] },
|
||
{ title: "Movement", items: ["SpeedPerState map", "DefaultWalkSpeed"] },
|
||
{ title: "Behavior", items: ["DefaultBehaviorTree (soft ref)"] },
|
||
];
|
||
profileCats.forEach((c, i) => {
|
||
const col = i % 3;
|
||
const row = Math.floor(i / 3);
|
||
const x = 0.5 + col * 4.15;
|
||
const y = 2.2 + row * 2.3;
|
||
s.addShape(pres.ShapeType.roundRect, { x: x, y: y, w: 3.95, h: 2.1, fill: { color: SAND }, line: { color: TERRA, width: 1 }, rectRadius: 0.08 });
|
||
s.addText(c.title, { x: x + 0.15, y: y + 0.1, w: 3.65, h: 0.35, fontSize: 14, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: x + 0.15, y: y + 0.45, w: 0.35, h: 0.04, fill: { color: GOLD } });
|
||
s.addText(c.items.map(t => ({ text: t, options: { bullet: true, fontSize: 11 } })),
|
||
{ x: x + 0.15, y: y + 0.55, w: 3.65, h: 1.4, color: CHARCOAL, fontFace: FONT_B, paraSpaceAfter: 3 });
|
||
});
|
||
|
||
s.addShape(pres.ShapeType.roundRect, { x: 0.5, y: 6.85, w: 12.3, h: 0.35, fill: { color: TERRA }, rectRadius: 0.04 });
|
||
s.addText("Example presets: Cowardly Villager • Aggressive Guard • Rival Gang Member", { x: 0.7, y: 6.88, w: 12, h: 0.3, fontSize: 11, color: SAND, italic: true, fontFace: FONT_B });
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 9 — COMPONENTS OVERVIEW
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("Components", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 36, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("Attach to Pawns as needed — most are optional.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
const components = [
|
||
{ name: "Personality", desc: "Traits, profile, state reactions", required: true },
|
||
{ name: "Perception", desc: "AI Perception wrapper, threat computation", required: "auto" },
|
||
{ name: "Team", desc: "Identity for non-AI pawns (player)", required: false },
|
||
{ name: "Combat", desc: "Attack events, fire/kill delegates", required: false },
|
||
{ name: "Spline Follower", desc: "Spline walking, junction detection", required: false },
|
||
];
|
||
components.forEach((c, i) => {
|
||
const y = 2.2 + i * 0.9;
|
||
s.addShape(pres.ShapeType.roundRect, { x: 0.5, y: y, w: 3.5, h: 0.8, fill: { color: TERRA }, rectRadius: 0.08 });
|
||
s.addText(c.name, { x: 0.5, y: y, w: 3.5, h: 0.8, fontSize: 16, bold: true, color: WHITE, align: "center", valign: "middle", fontFace: FONT_H });
|
||
|
||
s.addShape(pres.ShapeType.roundRect, { x: 4.2, y: y, w: 7.0, h: 0.8, fill: { color: SAND }, line: { color: TERRA, width: 1 }, rectRadius: 0.06 });
|
||
s.addText(c.desc, { x: 4.4, y: y + 0.1, w: 6.8, h: 0.6, fontSize: 13, color: CHARCOAL, valign: "middle", fontFace: FONT_B });
|
||
|
||
let tagText = c.required === true ? "Required" : (c.required === "auto" ? "Auto" : "Optional");
|
||
let tagColor = c.required === true ? TERRA : (c.required === "auto" ? SAGE_D : GOLD);
|
||
s.addShape(pres.ShapeType.roundRect, { x: 11.4, y: y + 0.2, w: 1.4, h: 0.4, fill: { color: tagColor }, rectRadius: 0.08 });
|
||
s.addText(tagText, { x: 11.4, y: y + 0.2, w: 1.4, h: 0.4, fontSize: 11, bold: true, color: WHITE, align: "center", valign: "middle", fontFace: FONT_H });
|
||
});
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 10 — PERCEPTION COMPONENT
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("Perception Component", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 36, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("Sight, hearing, damage senses — auto-configured.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
s.addText("Senses", { x: 0.5, y: 2.15, w: 4, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addText([
|
||
{ text: "Sight — vision cone + line of sight", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "Hearing — noise events with tags", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "Damage — damage received tracking", options: { bullet: true, fontSize: 13 } },
|
||
], { x: 0.5, y: 2.55, w: 4, h: 2, color: CHARCOAL, fontFace: FONT_B, paraSpaceAfter: 5 });
|
||
|
||
s.addText("Threat Scoring", { x: 4.8, y: 2.15, w: 4, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addText([
|
||
{ text: "Target priority (from Profile)", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "Recent damage weight", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "Proximity weight", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "Target persistence (80% score hold)", options: { bullet: true, fontSize: 13 } },
|
||
], { x: 4.8, y: 2.55, w: 4.2, h: 2.2, color: CHARCOAL, fontFace: FONT_B, paraSpaceAfter: 5 });
|
||
|
||
s.addText("Key Methods", { x: 9.3, y: 2.15, w: 3.5, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addText([
|
||
{ text: "GetHighestThreatActor()", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "CalculateThreatLevel()", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "GetThreatLocation()", options: { bullet: true, fontSize: 12 } },
|
||
{ text: "ClassifyActor()", options: { bullet: true, fontSize: 12 } },
|
||
], { x: 9.3, y: 2.55, w: 3.5, h: 2, color: CHARCOAL, fontFace: "Consolas", paraSpaceAfter: 4 });
|
||
|
||
s.addShape(pres.ShapeType.roundRect, { x: 0.5, y: 5.15, w: 12.3, h: 1.85, fill: { color: TERRA }, rectRadius: 0.1 });
|
||
s.addText("Perception / Threat Resolution", { x: 0.7, y: 5.25, w: 12, h: 0.35, fontSize: 14, bold: true, color: GOLD, fontFace: FONT_H });
|
||
s.addText("Detects ALL affiliations → filters by Hostile attitude. Supports separate ThreatTarget (e.g. AimTargetActor sphere) vs. owning Pawn. Line-of-sight tracking with last-known-position memory.", {
|
||
x: 0.7, y: 5.65, w: 12, h: 1.3, fontSize: 12, color: SAND, italic: true, fontFace: FONT_B
|
||
});
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 11 — COMBAT COMPONENT
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("Combat Component", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 36, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("Attack execution, cooldown, damage events.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
s.addText("Properties", { x: 0.5, y: 2.15, w: 6, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addText([
|
||
{ text: "AttackRange — max distance (cm)", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "AttackCooldown — minimum between attacks", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "AttackDamage — base damage value", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "CurrentTarget — replicated", options: { bullet: true, fontSize: 13 } },
|
||
], { x: 0.5, y: 2.55, w: 6, h: 2.3, color: CHARCOAL, fontFace: FONT_B, paraSpaceAfter: 5 });
|
||
|
||
s.addText("Methods & Events", { x: 7, y: 2.15, w: 6, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addText([
|
||
{ text: "CanAttack() — cooldown check", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "IsInAttackRange() — distance test", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "ExecuteAttack() — apply damage + multicast", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "OnAttackExecuted (multicast)", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "OnDamageReceived (server-only)", options: { bullet: true, fontSize: 13 } },
|
||
], { x: 7, y: 2.55, w: 6, h: 2.5, color: CHARCOAL, fontFace: FONT_B, paraSpaceAfter: 5 });
|
||
|
||
s.addShape(pres.ShapeType.roundRect, { x: 0.5, y: 5.3, w: 12.3, h: 1.7, fill: { color: TERRA }, rectRadius: 0.1 });
|
||
s.addText("Combat Type", { x: 0.7, y: 5.4, w: 12, h: 0.35, fontSize: 14, bold: true, color: GOLD, fontFace: FONT_H });
|
||
s.addText("NPC's combat type (Melee / Ranged) comes from IPS_AI_Behavior::GetBehaviorCombatType(). Melee = rush the target (no cooldown between re-positions). Ranged = maintain distance, use cover cycle, peek to fire.", {
|
||
x: 0.7, y: 5.75, w: 12, h: 1.2, fontSize: 12, color: SAND, italic: true, fontFace: FONT_B
|
||
});
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 12 — WORLD ACTORS
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("World Actors", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 36, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("Placed by level designers — drive navigation and tactics.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
const actors = [
|
||
{ name: "SplinePath", desc: "Placeable spline defining a navigation corridor. Filtered by NPCType. Bidirectional, with priority for junction selection." },
|
||
{ name: "SplineNetwork", desc: "WorldSubsystem — auto-detects intersections between SplinePath actors. Provides navigation queries, threat-aware switching." },
|
||
{ name: "CoverPoint", desc: "Manually placed tactical position. Cover or HidingSpot type, quality score, crouch flag, max occupants, type filter." },
|
||
];
|
||
actors.forEach((a, i) => {
|
||
const y = 2.2 + i * 1.5;
|
||
s.addShape(pres.ShapeType.roundRect, { x: 0.5, y: y, w: 12.3, h: 1.35, fill: { color: SAND }, line: { color: TERRA, width: 1 }, rectRadius: 0.1 });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: y, w: 3.5, h: 1.35, fill: { color: TERRA } });
|
||
s.addText(a.name, { x: 0.5, y: y, w: 3.5, h: 1.35, fontSize: 20, bold: true, color: WHITE, align: "center", valign: "middle", fontFace: FONT_H });
|
||
s.addText(a.desc, { x: 4.2, y: y + 0.15, w: 8.4, h: 1.05, fontSize: 13, color: CHARCOAL, valign: "middle", fontFace: FONT_B });
|
||
});
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 13 — BEHAVIOR TREE SERVICES & TASKS
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("Behavior Tree — Services & Tasks", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 30, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("Reusable BT nodes — build custom trees per NPC type.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
s.addText("Services (root-level)", { x: 0.5, y: 2.15, w: 6, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
const services = [
|
||
{ name: "UpdateThreat", desc: "Queries perception, writes threat BB keys" },
|
||
{ name: "EvaluateReaction", desc: "Computes state from traits + threat" },
|
||
{ name: "UpdateGaze", desc: "Manages eye contact, ConvAgent bridge" },
|
||
];
|
||
services.forEach((svc, i) => {
|
||
const y = 2.55 + i * 0.7;
|
||
s.addShape(pres.ShapeType.roundRect, { x: 0.5, y: y, w: 2.3, h: 0.55, fill: { color: SAGE_D }, rectRadius: 0.06 });
|
||
s.addText(svc.name, { x: 0.5, y: y, w: 2.3, h: 0.55, fontSize: 12, bold: true, color: WHITE, align: "center", valign: "middle", fontFace: FONT_H });
|
||
s.addText(svc.desc, { x: 2.9, y: y, w: 3.7, h: 0.55, fontSize: 11, color: CHARCOAL, valign: "middle", fontFace: FONT_B });
|
||
});
|
||
|
||
s.addText("Tasks (leaves)", { x: 7, y: 2.15, w: 6, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
const tasks = [
|
||
{ name: "FollowSpline", desc: "Drives SplineFollower" },
|
||
{ name: "FindAndFollowSpline", desc: "Auto-locate + follow" },
|
||
{ name: "Patrol", desc: "Cycle PatrolPoints" },
|
||
{ name: "FindCover", desc: "Manual + procedural cover" },
|
||
{ name: "CoverShootCycle", desc: "Cover → peek → fire cycle" },
|
||
{ name: "Attack", desc: "Chase + attack (Melee/Ranged)" },
|
||
{ name: "FleeFrom", desc: "Move away from threat" },
|
||
];
|
||
tasks.forEach((task, i) => {
|
||
const y = 2.55 + i * 0.58;
|
||
s.addShape(pres.ShapeType.roundRect, { x: 7, y: y, w: 2.3, h: 0.45, fill: { color: TERRA }, rectRadius: 0.06 });
|
||
s.addText(task.name, { x: 7, y: y, w: 2.3, h: 0.45, fontSize: 11, bold: true, color: WHITE, align: "center", valign: "middle", fontFace: FONT_H });
|
||
s.addText(task.desc, { x: 9.4, y: y, w: 3.5, h: 0.45, fontSize: 10, color: CHARCOAL, valign: "middle", fontFace: FONT_B });
|
||
});
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 14 — COVER SYSTEM
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("Cover System", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 36, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("Manual CoverPoints + procedural raycast fallback + EQS refinement.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
const coverCols = [
|
||
{
|
||
title: "Manual CoverPoints",
|
||
items: ["Placed by level designer", "Type: Cover or HidingSpot", "Quality score (0–1)", "MaxOccupants, Crouch flag", "Type filter (Any / Civ / Enemy / Protector)"]
|
||
},
|
||
{
|
||
title: "Procedural",
|
||
items: ["Fallback if no manual points", "Raycast sampling around threat", "LOS blockage test", "Advancement bias toward threat"]
|
||
},
|
||
{
|
||
title: "EQS Refinement",
|
||
items: ["OnCircle generator around cover", "LineOfSight filter", "Distance + quality tests", "Optional firing position refine"]
|
||
},
|
||
];
|
||
coverCols.forEach((c, i) => {
|
||
const x = 0.5 + i * 4.28;
|
||
s.addShape(pres.ShapeType.roundRect, { x: x, y: 2.2, w: 4.08, h: 3.1, fill: { color: SAND }, line: { color: TERRA, width: 1 }, rectRadius: 0.1 });
|
||
s.addText(c.title, { x: x + 0.2, y: 2.3, w: 3.78, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: x + 0.2, y: 2.72, w: 0.4, h: 0.04, fill: { color: GOLD } });
|
||
s.addText(c.items.map(t => ({ text: t, options: { bullet: true, fontSize: 11 } })),
|
||
{ x: x + 0.2, y: 2.85, w: 3.78, h: 2.3, color: CHARCOAL, fontFace: FONT_B, paraSpaceAfter: 3 });
|
||
});
|
||
|
||
// Cover cycle state machine
|
||
s.addShape(pres.ShapeType.roundRect, { x: 0.5, y: 5.55, w: 12.3, h: 1.45, fill: { color: TERRA }, rectRadius: 0.1 });
|
||
s.addText("Cover Cycle State Machine (CombatSubState)", { x: 0.7, y: 5.65, w: 12, h: 0.35, fontSize: 14, bold: true, color: GOLD, fontFace: FONT_H });
|
||
|
||
const subStates = ["Engaging", "AtCover", "MovingToFire", "Peeking", "ReturningToCover", "Advancing"];
|
||
subStates.forEach((sub, i) => {
|
||
const x = 0.7 + i * 2.0;
|
||
s.addShape(pres.ShapeType.roundRect, { x: x, y: 6.15, w: 1.9, h: 0.7, fill: { color: TERRA_D }, rectRadius: 0.05 });
|
||
s.addText(sub, { x: x, y: 6.15, w: 1.9, h: 0.7, fontSize: 11, bold: true, color: WHITE, align: "center", valign: "middle", fontFace: FONT_H });
|
||
});
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 15 — INTERFACE (IMPLEMENTERS GUIDE)
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("IPS_AI_Behavior_Interface", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 34, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("What your Pawn must implement (C++ or Blueprint).", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
const ifCats = [
|
||
{
|
||
title: "Identity",
|
||
items: ["GetBehaviorNPCType()", "SetBehaviorNPCType()", "IsBehaviorHostile()", "SetBehaviorHostile()"]
|
||
},
|
||
{
|
||
title: "Movement",
|
||
items: ["SetBehaviorMovementSpeed()", "GetBehaviorMovementSpeed()", "SetBehaviorCrouch()"]
|
||
},
|
||
{
|
||
title: "State Feedback",
|
||
items: ["OnBehaviorStateChanged()", "IsTargetActorValid()", "GetBehaviorThreatActor()"]
|
||
},
|
||
{
|
||
title: "Combat",
|
||
items: ["BehaviorStartAttack()", "BehaviorStopAttack()", "CanBehaviorAttack()", "GetBehaviorCombatType()"]
|
||
},
|
||
];
|
||
ifCats.forEach((c, i) => {
|
||
const col = i % 2;
|
||
const row = Math.floor(i / 2);
|
||
const x = 0.5 + col * 6.3;
|
||
const y = 2.2 + row * 2.4;
|
||
s.addShape(pres.ShapeType.roundRect, { x: x, y: y, w: 6.0, h: 2.2, fill: { color: TERRA }, rectRadius: 0.1 });
|
||
s.addText(c.title, { x: x + 0.2, y: y + 0.15, w: 5.6, h: 0.4, fontSize: 16, bold: true, color: GOLD, fontFace: FONT_H });
|
||
s.addText(c.items.map(t => ({ text: t, options: { bullet: true, fontSize: 12 } })),
|
||
{ x: x + 0.2, y: y + 0.6, w: 5.6, h: 1.55, color: SAND, fontFace: "Consolas", paraSpaceAfter: 3 });
|
||
});
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 16 — SETUP WORKFLOW
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("Setup Workflow", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 36, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("From zero to a behaving NPC in 6 steps.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
const bsteps = [
|
||
{ num: "1", title: "Personality Profile", desc: "Create DataAsset — traits, thresholds, DefaultBehaviorTree." },
|
||
{ num: "2", title: "Implement Interface", desc: "Pawn: implement IPS_AI_Behavior_Interface (identity, combat, movement)." },
|
||
{ num: "3", title: "Add Components", desc: "Pawn: add PersonalityComponent. Optional: Combat, SplineFollower." },
|
||
{ num: "4", title: "Behavior Tree", desc: "Branch on BehaviorState. Add services UpdateThreat + EvaluateReaction at root." },
|
||
{ num: "5", title: "Set AIController", desc: "Pawn's AIController class = APS_AI_Behavior_AIController." },
|
||
{ num: "6", title: "Place World Actors", desc: "Optional: SplinePaths, CoverPoints, SplineNetwork (auto)." },
|
||
];
|
||
bsteps.forEach((step, i) => {
|
||
const y = 2.2 + i * 0.78;
|
||
s.addShape(pres.ShapeType.ellipse, { x: 0.5, y: y, w: 0.7, h: 0.7, fill: { color: GOLD } });
|
||
s.addText(step.num, { x: 0.5, y: y, w: 0.7, h: 0.7, fontSize: 24, bold: true, color: TERRA, align: "center", valign: "middle", fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.roundRect, { x: 1.4, y: y, w: 11.4, h: 0.7, fill: { color: SAND }, line: { color: TERRA, width: 1 }, rectRadius: 0.05 });
|
||
s.addText(step.title, { x: 1.6, y: y + 0.05, w: 3.5, h: 0.3, fontSize: 13, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addText(step.desc, { x: 1.6, y: y + 0.35, w: 11.2, h: 0.35, fontSize: 11, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
});
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 17 — BLACKBOARD KEYS
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("Blackboard Keys", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 36, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("Auto-created by the AIController — use in your BT decorators and tasks.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
const bbKeys = [
|
||
{ name: "BehaviorState", type: "Enum", desc: "Current state (Idle, Combat, etc.)" },
|
||
{ name: "ThreatActor", type: "Object", desc: "Current highest-scored threat" },
|
||
{ name: "ThreatLocation", type: "Vector", desc: "Last known threat position" },
|
||
{ name: "ThreatLevel", type: "Float", desc: "Perceived threat (0–1+)" },
|
||
{ name: "CoverLocation", type: "Vector", desc: "Target cover position" },
|
||
{ name: "CoverPoint", type: "Object", desc: "Current CoverPoint actor" },
|
||
{ name: "PatrolIndex", type: "Int", desc: "Current patrol waypoint index" },
|
||
{ name: "HomeLocation", type: "Vector", desc: "Spawn / home point" },
|
||
{ name: "CurrentSpline", type: "Object", desc: "Active SplinePath" },
|
||
{ name: "SplineProgress", type: "Float", desc: "Distance along current spline" },
|
||
{ name: "CombatSubState", type: "Enum", desc: "Cover cycle sub-state (Peeking, etc.)" },
|
||
{ name: "LastKnownTargetPosition", type: "Vector", desc: "LOS-lost target memory" },
|
||
{ name: "PreferCover", type: "Bool", desc: "Combat/cover cycle toggle" },
|
||
{ name: "ConversationPaused", type: "Bool", desc: "Active dialogue pause flag" },
|
||
];
|
||
bbKeys.forEach((k, i) => {
|
||
const col = i % 2;
|
||
const row = Math.floor(i / 2);
|
||
const x = 0.5 + col * 6.3;
|
||
const y = 2.2 + row * 0.62;
|
||
s.addShape(pres.ShapeType.roundRect, { x: x, y: y, w: 1.8, h: 0.5, fill: { color: TERRA }, rectRadius: 0.05 });
|
||
s.addText(k.name, { x: x, y: y, w: 1.8, h: 0.5, fontSize: 10, bold: true, color: WHITE, align: "center", valign: "middle", fontFace: "Consolas" });
|
||
s.addShape(pres.ShapeType.roundRect, { x: x + 1.85, y: y + 0.1, w: 0.6, h: 0.3, fill: { color: GOLD }, rectRadius: 0.05 });
|
||
s.addText(k.type, { x: x + 1.85, y: y + 0.1, w: 0.6, h: 0.3, fontSize: 9, bold: true, color: WHITE, align: "center", valign: "middle", fontFace: FONT_H });
|
||
s.addText(k.desc, { x: x + 2.55, y: y, w: 3.7, h: 0.5, fontSize: 10, color: CHARCOAL, valign: "middle", italic: true, fontFace: FONT_B });
|
||
});
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 18 — NETWORKING
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("Networking", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 36, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("Server-authoritative AI, minimal replication for visuals.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
s.addText("Server-only", { x: 0.5, y: 2.15, w: 6, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addText([
|
||
{ text: "All AI planning & decision-making", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "Threat evaluation, state transitions", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "Perception stimuli processing", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "Path selection, cover choice", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "Combat targeting", options: { bullet: true, fontSize: 13 } },
|
||
], { x: 0.5, y: 2.55, w: 6, h: 2.7, color: CHARCOAL, fontFace: FONT_B, paraSpaceAfter: 5 });
|
||
|
||
s.addText("Replicated to clients", { x: 7, y: 2.15, w: 6, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addText([
|
||
{ text: "CurrentState (OnRep fires delegate)", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "PerceivedThreatLevel (HUD/debug)", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "CurrentTarget (anims/visuals)", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "CurrentSpline, bIsFollowing", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "OnAttackExecuted (multicast)", options: { bullet: true, fontSize: 13 } },
|
||
], { x: 7, y: 2.55, w: 6, h: 2.7, color: CHARCOAL, fontFace: FONT_B, paraSpaceAfter: 5 });
|
||
|
||
s.addShape(pres.ShapeType.roundRect, { x: 0.5, y: 5.4, w: 12.3, h: 1.6, fill: { color: TERRA }, rectRadius: 0.1 });
|
||
s.addText("Character movement syncs via CharacterMovementComponent. Spline follower updates server-side, position replicates naturally. Clients receive enough state for animation and HUD without any AI logic running locally.", {
|
||
x: 0.7, y: 5.6, w: 12, h: 1.2, fontSize: 13, color: SAND, italic: true, fontFace: FONT_B, valign: "middle"
|
||
});
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 19 — INTEGRATION WITH CONVAGENT
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("Integration with PS_AI_ConvAgent", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 28, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("Optional — behavior and conversation plugins talk via reflection.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
const integrations = [
|
||
{ title: "Gaze Bridge", desc: "AIController discovers GazeComponent on the Pawn, sets target during Idle/Patrol (proximity gaze) and forwards current threat during Combat." },
|
||
{ title: "Conversation Pause", desc: "When ConvAgent is conversing, AI planning pauses — NPC stops moving, waits. Local VAD detects user speech." },
|
||
{ title: "Disguise Reveal", desc: "Enemy NPC with IsBehaviorHostile=false starts as Civilian TeamId. Flips to hostile via interface when triggered by dialogue." },
|
||
{ title: "Forced State", desc: "ConvAgent LLM can invoke tools that call ForceState(Scripted) or ForceState(Fleeing) for narrative control." },
|
||
];
|
||
integrations.forEach((item, i) => {
|
||
const col = i % 2;
|
||
const row = Math.floor(i / 2);
|
||
const x = 0.5 + col * 6.3;
|
||
const y = 2.2 + row * 2.3;
|
||
s.addShape(pres.ShapeType.roundRect, { x: x, y: y, w: 6.0, h: 2.1, fill: { color: SAND }, line: { color: TERRA, width: 1 }, rectRadius: 0.1 });
|
||
s.addText(item.title, { x: x + 0.2, y: y + 0.15, w: 5.6, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: x + 0.2, y: y + 0.58, w: 0.4, h: 0.04, fill: { color: GOLD } });
|
||
s.addText(item.desc, { x: x + 0.2, y: y + 0.7, w: 5.6, h: 1.3, fontSize: 12, color: CHARCOAL, fontFace: FONT_B });
|
||
});
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 20 — DEBUG TOOLS
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide({ masterName: "CONTENT" });
|
||
s.addText("Debug Tools", { x: 0.5, y: 0.6, w: 12, h: 0.8, fontSize: 36, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addShape(pres.ShapeType.rect, { x: 0.5, y: 1.45, w: 0.6, h: 0.06, fill: { color: GOLD } });
|
||
s.addText("Visualize state, perception, and targeting at runtime.", { x: 0.5, y: 1.65, w: 12, h: 0.4, fontSize: 14, color: CHARCOAL, italic: true, fontFace: FONT_B });
|
||
|
||
s.addText("Per-NPC Debug", { x: 0.5, y: 2.15, w: 6, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addText([
|
||
{ text: "PersonalityComponent.bDebug — floating text", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "Name, NPCType, TeamId, State", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "ThreatLevel, ThreatActor", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "Hostile, active spline", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "SplineFollower debug sphere (green)", options: { bullet: true, fontSize: 13 } },
|
||
], { x: 0.5, y: 2.55, w: 6, h: 2.8, color: CHARCOAL, fontFace: FONT_B, paraSpaceAfter: 5 });
|
||
|
||
s.addText("Global Logging", { x: 7, y: 2.15, w: 6, h: 0.4, fontSize: 16, bold: true, color: TERRA, fontFace: FONT_H });
|
||
s.addText([
|
||
{ text: "CVar: ps.ai.Behavior.Debug 1", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "Toggles verbose logs globally", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "LogPS_AI_Behavior category", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "BTView / AIDebug (Unreal built-in)", options: { bullet: true, fontSize: 13 } },
|
||
{ text: "EQS Visualizer for cover queries", options: { bullet: true, fontSize: 13 } },
|
||
], { x: 7, y: 2.55, w: 6, h: 2.8, color: CHARCOAL, fontFace: FONT_B, paraSpaceAfter: 5 });
|
||
|
||
s.addShape(pres.ShapeType.roundRect, { x: 0.5, y: 5.5, w: 12.3, h: 1.5, fill: { color: TERRA }, rectRadius: 0.1 });
|
||
s.addText("Pro tip", { x: 0.7, y: 5.6, w: 12, h: 0.35, fontSize: 14, bold: true, color: GOLD, fontFace: FONT_H });
|
||
s.addText("Enable bDebug only on specific NPCs (or via a debug HUD key). Global debug logs can be overwhelming in crowded scenes. The floating text is cheap but accumulates.",
|
||
{ x: 0.7, y: 5.95, w: 12, h: 1.0, fontSize: 12, color: SAND, italic: true, fontFace: FONT_B });
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SLIDE 21 — SUMMARY
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
s = pres.addSlide();
|
||
s.background = { color: TERRA };
|
||
s.addShape(pres.ShapeType.rect, { x: 0, y: 2.5, w: 13.333, h: 0.05, fill: { color: GOLD } });
|
||
s.addText("Summary", { x: 0.6, y: 0.8, w: 12, h: 1.2, fontSize: 54, bold: true, color: WHITE, fontFace: FONT_H });
|
||
s.addText("Complete NPC behavior stack for tactical game AI.", { x: 0.6, y: 2.0, w: 12, h: 0.5, fontSize: 18, color: SAND, italic: true, fontFace: FONT_B });
|
||
|
||
const bsummary = [
|
||
{ h: "Personality-driven", t: "Three traits modulate every decision" },
|
||
{ h: "Cover-aware", t: "Manual CoverPoints + procedural fallback + EQS" },
|
||
{ h: "Spline navigation", t: "Network with junction detection, type filtering" },
|
||
{ h: "Perception built-in", t: "Sight + hearing + damage, priority-based threat" },
|
||
{ h: "Server-authoritative", t: "Minimal replication, client just animates" },
|
||
{ h: "Plugin-friendly", t: "Gaze bridge to ConvAgent, interface-only dependency" },
|
||
];
|
||
bsummary.forEach((item, i) => {
|
||
const col = i % 2;
|
||
const row = Math.floor(i / 2);
|
||
const x = 0.6 + col * 6.2;
|
||
const y = 3.0 + row * 1.4;
|
||
s.addShape(pres.ShapeType.roundRect, { x: x, y: y, w: 5.9, h: 1.2, fill: { color: TERRA_D }, line: { color: GOLD, width: 1 }, rectRadius: 0.1 });
|
||
s.addText(item.h, { x: x + 0.2, y: y + 0.1, w: 5.5, h: 0.4, fontSize: 18, bold: true, color: GOLD, fontFace: FONT_H });
|
||
s.addText(item.t, { x: x + 0.2, y: y + 0.55, w: 5.5, h: 0.6, fontSize: 12, color: SAND, italic: true, fontFace: FONT_B });
|
||
});
|
||
|
||
s.addText("ASTERION • PS_AI_Behavior • 2026", { x: 0.6, y: 6.9, w: 12, h: 0.4, fontSize: 12, color: SAND, fontFace: FONT_B });
|
||
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
// SAVE
|
||
// ═══════════════════════════════════════════════════════════════════
|
||
pres.writeFile({ fileName: "PS_AI_Behavior_Documentation.pptx" })
|
||
.then(name => console.log(`Generated: ${name}`))
|
||
.catch(err => { console.error(err); process.exit(1); });
|