u-Ai

World state aware, simple Utility AI framework

Usage

u-Ai works with 3 basic objects:

• World State (State)
  • Houses all Agents and contains world data
• Agent
  • Ai Agents, with actions and stuff..
• Ai
  • Agent behavior definitions

Bootstrap

import{SimpleState}from'./SimpleState'letworld=newSimpleState(5)setInterval(()=>{world.simulate()},1000)

State

import{SimpleAgent}from'./SimpleAgent'import{State}from'../src'/** * SimpleState */exportclassSimpleStateextendsState{/** * constructor * @param nOfAgents Number of agents to create */constructor(nOfAgents: number){super(nOfAgents)}/** * Function called to create an Agent */createAgent(): void{letid=Math.random().toString(36).substring(7)this.agents[id]=newSimpleAgent(id)}/** * Function called to run the simulation (a tick) */simulate(): void{for(constidinthis.agents){this.agents[id].simulate(this)}}}

Agent

import{Agent}from'../src'import{SimpleAi}from'./SimpleAi'import{SimpleState}from'./SimpleState'/** * SimpleAgent */exportclassSimpleAgentextendsAgent{/** * constructor * @param id Agent unique ID */constructor(id: string){super(id)// AI instance and behaviorthis.ai=newSimpleAi(this)}/** * (Mock) Get distance to nearest enemy * @param wState worldState */getDistanceToEnemy(wState:SimpleState): number{returnMath.random()*100}/** * (Mock) Get hunger */gethunger():number{returnMath.random()*100}/** * Agent specific function/action * @param s String to talk */talk(s: string): void{console.log(`Agent: ${this.id}: ${s}`);}}

Ai

import{Ai,State,Action}from'../src'import{SimpleAgent}from'./SimpleAgent'exportclassSimpleAiextendsAi{/** * constructor * @param agent Agent reference */constructor(agent: SimpleAgent){super(agent)// Ai debug flagthis.debug=false/** * Adds an action called "Flee" * e.g "Move to", "Fire at", "Talk", "Flee" */this.addAction('Flee',(action: Action)=>{// pre-condition, if not fulfilled action will be skippedaction.setCondition((wState: State,agent: SimpleAgent)=>{return!agent.isBlocked})// the higher the score better the action will be weightedaction.addScoreFunction('Distance to monster',(wState: State,agent: SimpleAgent)=>{returnagent.getDistanceToEnemy(wState)<60 ? 100 : 0})// consequence if action triggersaction.setAction((wState: State,agent: SimpleAgent)=>{agent.talk('Flee!!!')})})this.addAction('Eat',(action: Action)=>{action.addScoreFunction('Hunger high',(wState: State,agent: SimpleAgent)=>{returnagent.hunger})action.addScoreFunction('Random chance',(wState: State,agent: SimpleAgent)=>Math.random()*25)action.setAction((wState: State,agent: SimpleAgent)=>{agent.talk('Eating')})})}}