{"id":17982695,"url":"https://github.com/exane/utility-ai","last_synced_at":"2025-03-25T19:31:39.754Z","repository":{"id":78155820,"uuid":"120310964","full_name":"exane/utility-ai","owner":"exane","description":"A small Utility Ai Framework","archived":false,"fork":false,"pushed_at":"2018-05-06T11:43:21.000Z","size":11,"stargazers_count":17,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-20T17:38:27.119Z","etag":null,"topics":["ai","artificial-intelligence","framework","game-development","javascript","js","node","nodejs","utility","utility-ai","web"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/exane.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-05T13:51:32.000Z","updated_at":"2022-03-29T05:06:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"9ce70c3e-bb9a-46ea-a2a3-fcc7a27deab4","html_url":"https://github.com/exane/utility-ai","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exane%2Futility-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exane%2Futility-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exane%2Futility-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exane%2Futility-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/exane","download_url":"https://codeload.github.com/exane/utility-ai/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245530254,"owners_count":20630516,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","artificial-intelligence","framework","game-development","javascript","js","node","nodejs","utility","utility-ai","web"],"created_at":"2024-10-29T18:14:53.139Z","updated_at":"2025-03-25T19:31:39.749Z","avatar_url":"https://github.com/exane.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/exane/utility-ai.svg?branch=master)](https://travis-ci.org/exane/utility-ai)\n[![npm version](https://badge.fury.io/js/utility-ai.svg)](https://badge.fury.io/js/utility-ai)\n\n---\n\n# Utility Ai\n\n## A small Utility Ai Framework\n\n### Install\n\n```sh\nnpm install utility-ai\nyarn add utility-ai\n```\n\n### Usage\n\n```js\n  const UtilityAi = require(\"utility-ai\")\n\n  utility_ai = new UtilityAi\n\n  // define your actions e.g \"Move to Enemy\", \"Fire at Enemy\", \"Move to Cover\", \"Reload Gun\"\n  utility_ai.addAction(\"Move to Enemy\", action =\u003e {\n\n    // pre-conditions for actions, if not fulfilled all actions will be skipped\n    action.condition(({ player }) =\u003e {\n      if (player.isStuck()) {\n        return false\n      }\n\n      // explicit return of true needed to fulfill condition\n      return true\n    })\n\n    // each score expects a number as return value, the higher the better the action will be weighted\n    action.score(\"Distance to Enemy\", ({ player, enemy }) =\u003e {\n      return player.distanceTo(enemy)\n    })\n\n    action.score(\"Gun is not loaded\", ({ player }) =\u003e {\n      return player.gunEmpty() \u0026\u0026 -100\n    })\n\n  })\n\n  utility_ai.addAction(\"Fire at Enemy\", action =\u003e {\n\n    action.score(\"Proximity to Enemy \u003c 50\", ({ player, enemy }) =\u003e {\n      return player.distanceTo(enemy) \u003c 50 \u0026\u0026 75\n    })\n\n    action.score(\"Cannot make it to cover\", ({ player }) =\u003e {\n      return player.nextCoverDistance() \u003e 25 \u0026\u0026 50\n    })\n\n    action.score(\"Gun is not loaded\", ({ player }) =\u003e {\n      return player.gunEmpty() \u0026\u0026 -125\n    })\n\n  })\n\n  utility_ai.addAction(\"Move to Cover\", action =\u003e {\n\n    action.score(\"Is not in cover\", ({ player }) =\u003e {\n      return !player.isInCover() \u0026\u0026 50\n    })\n\n    action.score(\"Proximity to Cover \u003c 50\", ({ player }) =\u003e {\n      return player.nextCoverDistance() \u003c 50 \u0026\u0026 50\n    })\n\n  })\n\n  utility_ai.addAction(\"Reload Gun\", action =\u003e {\n\n    action.score(\"Gun is not loaded\", ({ player }) =\u003e {\n      return player.gunEmpty() \u0026\u0026 75\n    })\n\n    action.score(\"Is in Cover\", ({ player }) =\u003e {\n      return player.isInCover() \u0026\u0026 50\n    })\n\n    action.score(\"Gun is loaded\", ({ player }) =\u003e {\n      return !player.gunEmpty() \u0026\u0026 -125\n    })\n\n  })\n\n  const data = {\n    player: {...},\n    enemy: {...}\n  }\n\n  // starts the evaluation of a given world state and returns its best action\n  const result = utility_ai.evaluate(data)\n  // e.g. result = { action: \"Move to Cover\", score: 100 }\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexane%2Futility-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexane%2Futility-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexane%2Futility-ai/lists"}