PHPackages mrdev/lugo4php - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. mrdev/lugo4php ActiveLibrary[Utility & Helpers](/categories/utility) mrdev/lugo4php ============== Cliente PHP para Lugo Bots 030PHP Since Sep 28Pushed 1y ago1 watchersCompare [ Source](https://github.com/mauriciorobertodev/lugo4php)[ Packagist](https://packagist.org/packages/mrdev/lugo4php)[ RSS](/packages/mrdev-lugo4php/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) Lugo 4 PHP ========== [](#lugo-4-php) Cliente em PHP para criar [Lugo Bots](https://lugobots.ai/) [![PRs welcome!](https://camo.githubusercontent.com/60ae5a7e551591190d6aeed50d0733282e3a64b022a697e821c85af4f8064af8/68747470733a2f2f696d672e736869656c64732e696f2f7374617469632f76313f6c6162656c3d505273266d6573736167653d57454c434f4d45267374796c653d666f722d7468652d626164676526636f6c6f723d336238326636266c6162656c436f6c6f723d323232323232)](https://camo.githubusercontent.com/60ae5a7e551591190d6aeed50d0733282e3a64b022a697e821c85af4f8064af8/68747470733a2f2f696d672e736869656c64732e696f2f7374617469632f76313f6c6162656c3d505273266d6573736167653d57454c434f4d45267374796c653d666f722d7468652d626164676526636f6c6f723d336238326636266c6162656c436f6c6f723d323232323232) [ ![contributors](https://camo.githubusercontent.com/fff2b47bec7b4dc4dc795a6596e6503601695f1d25d02e4ff25e5ee7078c591f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6e7472696275746f72732f6d6175726963696f726f626572746f6465762f6c75676f347068703f636f6c6f723d336238326636266c6162656c3d434f4e5452494255544f5253266c6f676f3d334334323442266c6f676f436f6c6f723d334334323442267374796c653d666f722d7468652d6261646765266c6162656c436f6c6f723d323232323232) ](https://github.com/mauriciorobertodev/lugo4php/graphs/contributors) ![last update](https://camo.githubusercontent.com/fa48c99d697e336c2c98b19ebcae1f01cc06f497bc0fb95075a96a3dac61a55b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f6d6175726963696f726f626572746f6465762f6c75676f347068703f636f6c6f723d336238326636266c6162656c3d4c41535420555044415445266c6f676f3d334334323442266c6f676f436f6c6f723d334334323442267374796c653d666f722d7468652d6261646765266c6162656c436f6c6f723d323232323232) [ ![forks](https://camo.githubusercontent.com/e6b478dcac9c2fb782e18e603aa5d831d3fd6f7f9bd972f4a971644dd847594a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6d6175726963696f726f626572746f6465762f6c75676f347068703f636f6c6f723d336238326636266c6162656c3d464f524b53266c6f676f3d334334323442266c6f676f436f6c6f723d334334323442267374796c653d666f722d7468652d6261646765266c6162656c436f6c6f723d323232323232) ](https://github.com/mauriciorobertodev/lugo4php/network/members) [ ![stars](https://camo.githubusercontent.com/06ee0e182b9e60d950d46e0cf1b6f59eabb0313105bdd676b1a588ae8a42711d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6d6175726963696f726f626572746f6465762f6c75676f347068703f636f6c6f723d336238326636266c6162656c3d5354415253266c6f676f3d334334323442266c6f676f436f6c6f723d334334323442267374796c653d666f722d7468652d6261646765266c6162656c436f6c6f723d323232323232) ](https://github.com/mauriciorobertodev/lugo4php/stargazers) [ ![open issues](https://camo.githubusercontent.com/5fae30b3aa9637fef654278d91620f1de46551de967310fc5f52b9553e522b1d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6d6175726963696f726f626572746f6465762f6c75676f347068703f636f6c6f723d336238326636266c6162656c3d49535355455353266c6f676f3d334334323442266c6f676f436f6c6f723d334334323442267374796c653d666f722d7468652d6261646765266c6162656c436f6c6f723d323232323232) ](https://github.com/mauriciorobertodev/lugo4php/issues/) [ ![license](https://camo.githubusercontent.com/c89f5e032b30e23d80b1266a812be463ae9910a0324f91f8eeabdb148c713cd3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d6175726963696f726f626572746f6465762f6c75676f347068702e7376673f636f6c6f723d336238326636266c6162656c3d4c4943454e5345266c6f676f3d334334323442266c6f676f436f6c6f723d334334323442267374796c653d666f722d7468652d6261646765266c6162656c436f6c6f723d323232323232) ](https://github.com/mauriciorobertodev/lugo4php/blob/master/LICENSE) [![Alt text](https://raw.githubusercontent.com/mauriciorobertodev/lugo4php/main/screenshot.png)](https://raw.githubusercontent.com/mauriciorobertodev/lugo4php/main/screenshot.png) 🌟 Sobre o projeto ----------------- [](#star2-sobre-o-projeto) Lugo4PHP é um pacote feito em PHP criado para conectar um bot com servidor do [Lugo Bots](https://lugobots.ai/), escondendo a complexidade da conexão gRPC e disponibilizando várias classes e métodos que auxiliam um desenvolvedor a criar seu próprio bot. ### 🎯 Features [](#dart-features) - Conectar ao game server do Lugo Bots. - Classe env para capturar as variáveis e validar. - Wrapper de classes do game para uma tipagem mais forte. - Vários métodos comumente usadas já embutido no `Point` e no `Vector2D`, por exemplo `add()`, `scale()`, `subtract()`, `divide()` e outros... - Vários métodos comumente usadas já embutido no `Player` e `Ball`, por exemplo `$ball->distanceToPoint($point)`, `$ball->directionToPlayer($player)` e outros... - Vários métodos de atalho para um acesso mais rápido e claro, por exemplo `$inspector->getBallDirection()` em vez de `$inspector->getBall()->getVelocity()->getDirection()`. - Vários métodos alternativos para gerar uma ordem, por exemplo `$inspector->makeOrderLookAtDirection($direction)`, `$inspector->makeOrderMoveToRegion($region)`, `$inspector->makeOrderKickToPlayer($player)` e outros... - Vários métodos com duplicados, podendo optar por um que lança uma exceção ou um retorno nulo, por exemplo `$inspector->getMyPlayer(10)` (lança um erro caso o jogador não exista) e `$inspector->tryGetMyPlayer(10)` (retorna null caso o jogador não exista). - 94% do código coberto por testes automatizados, facilitando o incremento de novas funcionalidades, com uma change muito menor de quebrar as já existentes. - Totalmente documentada, para uma busca rápida, acesse: [Lugo4php Docs](https://lugo4php.mauricioroberto.com). ⚡ Como usar ----------- [](#zap-como-usar) [Veja o the-dummies-php, um bot criado usando esse pacote](https://github.com/mauriciorobertodev/the-dummies-php) 🔧 Desenvolvimento ----------------- [](#wrench-desenvolvimento) Clone o projeto ``` git clone https://github.com/mauriciorobertodev/lugo4php.git ``` Entre na pasta do projeto ``` cd lugo4php ``` Instale as dependências ``` composer install ``` Rode um jogo de teste usando o `BotTester` ``` docker compose -f ./example/bot/docker-compose.yml up --remove-orphans ``` 👋 Contribuindo -------------- [](#wave-contribuindo) Contribuições são sempre bem vindas! 1. Faça o *fork* do projeto () 2. Crie uma *branch* para sua modificação (`git checkout -b meu-novo-recurso`) 3. Faça o *commit* (`git commit -am 'Adicionando um novo recurso...'`) 4. *Push* (`git push origin meu-novo-recurso`) 5. Crie um novo *Pull Request* [ ![](https://camo.githubusercontent.com/00de9b84dbe7b413f9921164b418ae8e6a58e956293e2d9586c29662e71d1191/68747470733a2f2f636f6e747269622e726f636b732f696d6167653f7265706f3d6d6175726963696f726f626572746f6465762f6c75676f34706870)](https://github.com/mauriciorobertodev/lugo4php/graphs/contributors) 🔒 License --------- [](#lock-license) Licença MIT (MIT). Consulte o [arquivo de licença](https://github.com/mauriciorobertodev/lugo4php/LICENSE) para obter mais informações. 🔗 Links úteis ------------- [](#link-links-úteis) Portfolio: [mauricioroberto.com/](mauricioroberto.com/) Link do projeto: Link da documentação: Link do the-dummies-php: 💎 Créditos/Reconhecimento ------------------------- [](#gem-créditosreconhecimento) - [Shields.io](https://shields.io/) - [Awesome Readme Template](https://github.com/Louis3797/awesome-readme-template) - [Emoji Cheat Sheet](https://github.com/ikatyang/emoji-cheat-sheet/blob/master/README.md#travel--places) 🔬 Referências ------------- [](#microscope-referências) - [Lugo Bots Specs](https://spec.lugobots.ai/) - [lugo4node](https://github.com/lugobots/lugo4node) - [gRPC php Quick Start](https://grpc.io/docs/languages/php/quickstart/) ### Health Score 16 — LowBetter than 5% of packages Maintenance29 Infrequent updates — may be unmaintained Popularity7 Limited adoption so far Community7 Small or concentrated contributor base Maturity17 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/d42e375f445ea94cc5c70d66acc79d6c92ef023e2cdbf35e5c2db5a8117eeace?d=identicon)[Mauricio Roberto Dev](/maintainers/Mauricio%20Roberto%20Dev) --- Top Contributors [![mauriciorobertodev](https://avatars.githubusercontent.com/u/75261537?v=4)](https://github.com/mauriciorobertodev "mauriciorobertodev (21 commits)") --- Tags grpc-clientlugo-botsphp ### Embed Badge ![Health badge](/badges/mrdev-lugo4php/health.svg) ``` [![Health](https://phpackages.com/badges/mrdev-lugo4php/health.svg)](https://phpackages.com/packages/mrdev-lugo4php) ``` ### Alternatives [nathanmac/laravel-guid Simple GUID generator Package for Laravel 4 105.7k](/packages/nathanmac-laravel-guid) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)