TITLE

Fullscreen Terminal UI for MUGS, including App and game UIs


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/MUGS::UI::TUI/README.md","sources":[],"node":{"type":"block","id":"JiuEcXuJzYI_GGTmEs4ZJ","margin":"","name":"root","content":[{"type":"para","id":"nr5H5gASFAP9O6bCsH2yH","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":137,"offset":136}},"text":"text","content":[{"meta":"https://github.com/Raku-MUGS/MUGS-UI-TUI/actions","type":"fcode","name":"L","content":[{"type":"block","id":"L8zn7_AlfNJuZHAqKYnuE","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":86,"offset":85}},"content":[{"type":"image","src":"https://github.com/Raku-MUGS/MUGS-UI-TUI/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"k0mOLH8cvd3GwuSUQzdiD","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":138},"end":{"line":3,"column":7,"offset":144}},"content":["NAME"]},{"type":"para","id":"Q9AvG2WcpghtVLjnUnplq","margin":"","location":{"start":{"line":5,"column":1,"offset":146},"end":{"line":5,"column":76,"offset":221}},"text":"text","content":["MUGS::UI::TUI - Fullscreen Terminal UI for MUGS, including App and game UIs"]},{"type":"block","id":"Ur_3K320FI7s7LbKRnuXy","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":223},"end":{"line":7,"column":11,"offset":233}},"content":["SYNOPSIS"]},{"type":"block","id":"GBhct1yL0b98LI02vEyXn","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":235},"end":{"line":54,"column":62,"offset":1717}},"content":[{"type":"verbatim","value":"# Set up a full-stack MUGS-UI-TUI development environment\nmkdir MUGS\ncd MUGS\ngit clone git@github.com:Raku-MUGS/MUGS-Core.git\ngit clone git@github.com:Raku-MUGS/MUGS-Games.git\ngit clone git@github.com:Raku-MUGS/MUGS-UI-TUI.git\n\ncd MUGS-Core\nzef install --exclude=\"pq:ver<5>:from<native>\" .\nmugs-admin create-universe\n\ncd ../MUGS-Games\nzef install .\n\ncd ../MUGS-UI-TUI\nzef install --deps-only .  # Or skip --deps-only if you prefer\n\n\n### LOCAL PLAY\n\n# Play games using a local TUI UI, using an internal stub server and ephemeral data\nmugs-tui\n\n# Play games using an internal stub server accessing the long-lived data set\nmugs-tui --universe=<universe-name>  # 'default' if set up as above\n\n# Log in and play games on a WebSocket server using a local TUI UI\nmugs-tui --server=<host>:<port>\n\n\n### GAME SERVERS\n\n# Start a TLS WebSocket game server on localhost:10000 using fake certs\nmugs-ws-server\n\n# Specify a different MUGS identity universe (defaults to \"default\")\nmugs-ws-server --universe=other-universe\n\n# Start a TLS WebSocket game server on different host:port\nmugs-ws-server --host=<hostname> --port=<portnumber>\n\n# Start a TLS WebSocket game server using custom certs\nmugs-ws-server --private-key-file=<path> --certificate-file=<path>\n\n# Write a Log::Timeline JSON log for the WebSocket server\nLOG_TIMELINE_JSON_LINES=log/mugs-ws-server mugs-ws-server"}]},{"type":"block","id":"l9Jvb7AS57p-qb7pvEvpG","margin":"","level":1,"name":"head","location":{"start":{"line":56,"column":1,"offset":1719},"end":{"line":56,"column":14,"offset":1732}},"content":["DESCRIPTION"]},{"type":"para","id":"nARb1-dDYpuGO3D76i2HE","margin":"","location":{"start":{"line":58,"column":1,"offset":1734},"end":{"line":58,"column":90,"offset":1823}},"text":"text","content":[{"type":"fcode","name":"B","content":["NOTE: See the ",{"meta":"https://github.com/Raku-MUGS/MUGS","type":"fcode","name":"L","content":["top-level MUGS repo"]}," for more info."]}]},{"type":"para","id":"5Z1b0mzZM69N2pQlC2ZrK","margin":"","location":{"start":{"line":60,"column":1,"offset":1825},"end":{"line":60,"column":226,"offset":2050}},"text":"text","content":["MUGS::UI::TUI is a TUI (Terminal UI) app (",{"type":"fcode","name":"C","content":["mugs-tui"]},") and a growing set of UI plugins to play games in ",{"meta":"https://github.com/Raku-MUGS/MUGS-Core","type":"fcode","name":"L","content":["MUGS-Core"]}," and ",{"meta":"https://github.com/Raku-MUGS/MUGS-Games","type":"fcode","name":"L","content":["MUGS-Games"]}," via the TUI."]},{"type":"para","id":"LrobhErtaNX4kDkFiGF0E","margin":"","location":{"start":{"line":62,"column":1,"offset":2052},"end":{"line":62,"column":207,"offset":2258}},"text":"text","content":[{"type":"fcode","name":"B","content":["This early version only contains very limited modules and plugins, is missing significant functionality, and should not be considered \"fully released\" in the same way that the CLI and WebSimple UIs are."]}]},{"type":"block","id":"NlJXDPYjcVIxNKEOtOwmI","margin":"","level":1,"name":"head","location":{"start":{"line":64,"column":1,"offset":2260},"end":{"line":64,"column":9,"offset":2268}},"content":["AUTHOR"]},{"type":"para","id":"xJoyHDiiX3no7BT9c1g67","margin":"","location":{"start":{"line":66,"column":1,"offset":2270},"end":{"line":66,"column":35,"offset":2304}},"text":"text","content":["Geoffrey Broadwell ",{"meta":"mailto:gjb@sonic.net","type":"fcode","name":"L","content":["gjb@sonic.net"]}]},{"type":"block","id":"RoEzIliYBiUkaUqB4E9S7","margin":"","level":1,"name":"head","location":{"start":{"line":68,"column":1,"offset":2306},"end":{"line":68,"column":24,"offset":2329}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"uUvJyXBroVioS6WdZjzNM","margin":"","location":{"start":{"line":70,"column":1,"offset":2331},"end":{"line":70,"column":34,"offset":2364}},"text":"text","content":["Copyright 2021 Geoffrey Broadwell"]},{"type":"para","id":"r1hK0W163rUBgHTc75BTM","margin":"","location":{"start":{"line":72,"column":1,"offset":2366},"end":{"line":72,"column":96,"offset":2461}},"text":"text","content":["MUGS is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/MUGS::UI::TUI/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:japhb","authors":["Geoffrey Broadwell"],"build-depends":[],"depends":["MUGS::Core:ver<0.1.0>","MUGS::Games:ver<0.1.0>","Terminal::Print"],"description":"Fullscreen Terminal UI for MUGS, including App and game UIs","dist":"MUGS::UI::TUI:ver<0.1.0>:auth<zef:japhb>","license":"Artistic-2.0","name":"MUGS::UI::TUI","path":"M/UG/MUGS_UI_TUI/65f4edde0aa14978159eac8db1084d938fb030db.tar.gz","perl":"6.d","provides":{"MUGS::App::TUI":"lib/MUGS/App/TUI.rakumod","MUGS::UI::TUI":"lib/MUGS/UI/TUI.rakumod"},"resources":[],"source-url":"https://github.com/Raku-MUGS/MUGS-UI-TUI.git","tags":[],"test-depends":[],"version":"0.1.0"},"files":[{"file":"work_mods/zef/MUGS::UI::TUI/README.md","publishUrl":"/mods/zef/MUGS::UI::TUI/README.md"},{"file":"work_mods/zef/MUGS::UI::TUI/CODE_OF_CONDUCT.md","publishUrl":"/mods/zef/MUGS::UI::TUI/CODE_OF_CONDUCT.md"},{"file":"work_mods/zef/MUGS::UI::TUI/docs/CONTRIBUTING.md","publishUrl":"/mods/zef/MUGS::UI::TUI/docs/CONTRIBUTING.md"},{"file":"work_mods/zef/MUGS::UI::TUI/lib/MUGS/UI/TUI.rakumod","publishUrl":"/mods/zef/MUGS::UI::TUI/lib/MUGS/UI/TUI.rakumod"}],"src":"zef","url":"/mods/zef/MUGS::UI::TUI"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/MUGS::UI::TUI/README.md","sources":[],"node":{"type":"block","id":"JiuEcXuJzYI_GGTmEs4ZJ","margin":"","name":"root","content":[{"type":"para","id":"nr5H5gASFAP9O6bCsH2yH","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":137,"offset":136}},"text":"text","content":[{"meta":"https://github.com/Raku-MUGS/MUGS-UI-TUI/actions","type":"fcode","name":"L","content":[{"type":"block","id":"L8zn7_AlfNJuZHAqKYnuE","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":86,"offset":85}},"content":[{"type":"image","src":"https://github.com/Raku-MUGS/MUGS-UI-TUI/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"k0mOLH8cvd3GwuSUQzdiD","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":138},"end":{"line":3,"column":7,"offset":144}},"content":["NAME"]},{"type":"para","id":"Q9AvG2WcpghtVLjnUnplq","margin":"","location":{"start":{"line":5,"column":1,"offset":146},"end":{"line":5,"column":76,"offset":221}},"text":"text","content":["MUGS::UI::TUI - Fullscreen Terminal UI for MUGS, including App and game UIs"]},{"type":"block","id":"Ur_3K320FI7s7LbKRnuXy","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":223},"end":{"line":7,"column":11,"offset":233}},"content":["SYNOPSIS"]},{"type":"block","id":"GBhct1yL0b98LI02vEyXn","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":235},"end":{"line":54,"column":62,"offset":1717}},"content":[{"type":"verbatim","value":"# Set up a full-stack MUGS-UI-TUI development environment\nmkdir MUGS\ncd MUGS\ngit clone git@github.com:Raku-MUGS/MUGS-Core.git\ngit clone git@github.com:Raku-MUGS/MUGS-Games.git\ngit clone git@github.com:Raku-MUGS/MUGS-UI-TUI.git\n\ncd MUGS-Core\nzef install --exclude=\"pq:ver<5>:from<native>\" .\nmugs-admin create-universe\n\ncd ../MUGS-Games\nzef install .\n\ncd ../MUGS-UI-TUI\nzef install --deps-only .  # Or skip --deps-only if you prefer\n\n\n### LOCAL PLAY\n\n# Play games using a local TUI UI, using an internal stub server and ephemeral data\nmugs-tui\n\n# Play games using an internal stub server accessing the long-lived data set\nmugs-tui --universe=<universe-name>  # 'default' if set up as above\n\n# Log in and play games on a WebSocket server using a local TUI UI\nmugs-tui --server=<host>:<port>\n\n\n### GAME SERVERS\n\n# Start a TLS WebSocket game server on localhost:10000 using fake certs\nmugs-ws-server\n\n# Specify a different MUGS identity universe (defaults to \"default\")\nmugs-ws-server --universe=other-universe\n\n# Start a TLS WebSocket game server on different host:port\nmugs-ws-server --host=<hostname> --port=<portnumber>\n\n# Start a TLS WebSocket game server using custom certs\nmugs-ws-server --private-key-file=<path> --certificate-file=<path>\n\n# Write a Log::Timeline JSON log for the WebSocket server\nLOG_TIMELINE_JSON_LINES=log/mugs-ws-server mugs-ws-server"}]},{"type":"block","id":"l9Jvb7AS57p-qb7pvEvpG","margin":"","level":1,"name":"head","location":{"start":{"line":56,"column":1,"offset":1719},"end":{"line":56,"column":14,"offset":1732}},"content":["DESCRIPTION"]},{"type":"para","id":"nARb1-dDYpuGO3D76i2HE","margin":"","location":{"start":{"line":58,"column":1,"offset":1734},"end":{"line":58,"column":90,"offset":1823}},"text":"text","content":[{"type":"fcode","name":"B","content":["NOTE: See the ",{"meta":"https://github.com/Raku-MUGS/MUGS","type":"fcode","name":"L","content":["top-level MUGS repo"]}," for more info."]}]},{"type":"para","id":"5Z1b0mzZM69N2pQlC2ZrK","margin":"","location":{"start":{"line":60,"column":1,"offset":1825},"end":{"line":60,"column":226,"offset":2050}},"text":"text","content":["MUGS::UI::TUI is a TUI (Terminal UI) app (",{"type":"fcode","name":"C","content":["mugs-tui"]},") and a growing set of UI plugins to play games in ",{"meta":"https://github.com/Raku-MUGS/MUGS-Core","type":"fcode","name":"L","content":["MUGS-Core"]}," and ",{"meta":"https://github.com/Raku-MUGS/MUGS-Games","type":"fcode","name":"L","content":["MUGS-Games"]}," via the TUI."]},{"type":"para","id":"LrobhErtaNX4kDkFiGF0E","margin":"","location":{"start":{"line":62,"column":1,"offset":2052},"end":{"line":62,"column":207,"offset":2258}},"text":"text","content":[{"type":"fcode","name":"B","content":["This early version only contains very limited modules and plugins, is missing significant functionality, and should not be considered \"fully released\" in the same way that the CLI and WebSimple UIs are."]}]},{"type":"block","id":"NlJXDPYjcVIxNKEOtOwmI","margin":"","level":1,"name":"head","location":{"start":{"line":64,"column":1,"offset":2260},"end":{"line":64,"column":9,"offset":2268}},"content":["AUTHOR"]},{"type":"para","id":"xJoyHDiiX3no7BT9c1g67","margin":"","location":{"start":{"line":66,"column":1,"offset":2270},"end":{"line":66,"column":35,"offset":2304}},"text":"text","content":["Geoffrey Broadwell ",{"meta":"mailto:gjb@sonic.net","type":"fcode","name":"L","content":["gjb@sonic.net"]}]},{"type":"block","id":"RoEzIliYBiUkaUqB4E9S7","margin":"","level":1,"name":"head","location":{"start":{"line":68,"column":1,"offset":2306},"end":{"line":68,"column":24,"offset":2329}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"uUvJyXBroVioS6WdZjzNM","margin":"","location":{"start":{"line":70,"column":1,"offset":2331},"end":{"line":70,"column":34,"offset":2364}},"text":"text","content":["Copyright 2021 Geoffrey Broadwell"]},{"type":"para","id":"r1hK0W163rUBgHTc75BTM","margin":"","location":{"start":{"line":72,"column":1,"offset":2366},"end":{"line":72,"column":96,"offset":2461}},"text":"text","content":["MUGS is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/MUGS::UI::TUI/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:japhb","authors":["Geoffrey Broadwell"],"build-depends":[],"depends":["MUGS::Core:ver<0.1.0>","MUGS::Games:ver<0.1.0>","Terminal::Print"],"description":"Fullscreen Terminal UI for MUGS, including App and game UIs","dist":"MUGS::UI::TUI:ver<0.1.0>:auth<zef:japhb>","license":"Artistic-2.0","name":"MUGS::UI::TUI","path":"M/UG/MUGS_UI_TUI/65f4edde0aa14978159eac8db1084d938fb030db.tar.gz","perl":"6.d","provides":{"MUGS::App::TUI":"lib/MUGS/App/TUI.rakumod","MUGS::UI::TUI":"lib/MUGS/UI/TUI.rakumod"},"resources":[],"source-url":"https://github.com/Raku-MUGS/MUGS-UI-TUI.git","tags":[],"test-depends":[],"version":"0.1.0"},"files":[{"file":"work_mods/zef/MUGS::UI::TUI/README.md","publishUrl":"/mods/zef/MUGS::UI::TUI/README.md"},{"file":"work_mods/zef/MUGS::UI::TUI/CODE_OF_CONDUCT.md","publishUrl":"/mods/zef/MUGS::UI::TUI/CODE_OF_CONDUCT.md"},{"file":"work_mods/zef/MUGS::UI::TUI/docs/CONTRIBUTING.md","publishUrl":"/mods/zef/MUGS::UI::TUI/docs/CONTRIBUTING.md"},{"file":"work_mods/zef/MUGS::UI::TUI/lib/MUGS/UI/TUI.rakumod","publishUrl":"/mods/zef/MUGS::UI::TUI/lib/MUGS/UI/TUI.rakumod"}],"src":"zef","url":"/mods/zef/MUGS::UI::TUI"}}}
    =end data
    =end React


root

para

L<Examples| file:../examples/index.podlite>


L<Download |file:../download/index.podlite>


=begin React :component<HeaderCol> :id<menu> 
=para L<Documentation|/doc/introduction>
=para L<Modules| /mods>
=para L<Examples| file:../examples/index.podlite>
=para L<Download |file:../download/index.podlite>
=para L<About|file:../about/index.podlite>
=para 🔍 K<⌘K>/K<ctrl-K>
=end React


HEADER

FOOTER

MUGS::UI::TUI


WebSimple UI for MUGS, including HTTP gateway and game UIs


=begin data
{"type":"page","file":"work_mods/zef/MUGS::UI::WebSimple/README.md","sources":[],"node":{"type":"block","id":"n5_AweRPbpYrO99jv5jyH","margin":"","name":"root","content":[{"type":"para","id":"RZOUXlflQirHkkbIcSi6c","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":149,"offset":148}},"text":"text","content":[{"meta":"https://github.com/Raku-MUGS/MUGS-UI-WebSimple/actions","type":"fcode","name":"L","content":[{"type":"block","id":"aU1EzaPu63EG4FRnOrOB9","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":92,"offset":91}},"content":[{"type":"image","src":"https://github.com/Raku-MUGS/MUGS-UI-WebSimple/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"SMN4szi7YRRnypab3OetQ","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":150},"end":{"line":3,"column":7,"offset":156}},"content":["NAME"]},{"type":"para","id":"875AIp7VHrBkHYKJ8cSzB","margin":"","location":{"start":{"line":5,"column":1,"offset":158},"end":{"line":5,"column":79,"offset":236}},"text":"text","content":["MUGS-UI-WebSimple - WebSimple UI for MUGS, including HTTP gateway and game UIs"]},{"type":"block","id":"uUB0Cc1FfjN89k2EvFNjz","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":238},"end":{"line":7,"column":11,"offset":248}},"content":["SYNOPSIS"]},{"type":"block","id":"jghbWOuNt9ovfUz_ewrFr","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":250},"end":{"line":60,"column":30,"offset":2070}},"content":[{"type":"verbatim","value":"# Set up a full-stack MUGS-UI-WebSimple development environment\nmkdir MUGS\ncd MUGS\ngit clone git@github.com:Raku-MUGS/MUGS-Core.git\ngit clone git@github.com:Raku-MUGS/MUGS-Games.git\ngit clone git@github.com:Raku-MUGS/MUGS-UI-WebSimple.git\n\ncd MUGS-Core\nzef install .\nmugs-admin create-universe\n\ncd ../MUGS-Games\nzef install .\n\ncd ../MUGS-UI-WebSimple\n\n\n### GAME SERVER (handles actual gameplay; used by the web UI gateway)\n\n# Start a TLS WebSocket game server on localhost:10000 using fake certs\nmugs-ws-server\n\n# Specify a different MUGS identity universe (defaults to \"default\")\nmugs-ws-server --universe=other-universe\n\n# Start a TLS WebSocket game server on different host:port\nmugs-ws-server --host=<hostname> --port=<portnumber>\n\n# Start a TLS WebSocket game server using custom certs\nmugs-ws-server --private-key-file=<path> --certificate-file=<path>\n\n# Write a Log::Timeline JSON log for the WebSocket server\nLOG_TIMELINE_JSON_LINES=log/mugs-ws-server mugs-ws-server\n\n\n### WEB UI GATEWAY (frontend for a MUGS backend game server)\n\n# Start a web UI gateway on localhost:20000 to play games in a web browser\nmugs-web-simple --server-host=<websocket-host> --server-port=<websocket-port>\nmugs-web-simple --server=<websocket-host>:<websocket-port>\n\n# Start a web UI gateway on a different host:port\nmugs-web-simple --host=<hostname> --port=<portnumber>\n\n# Use a different CA to authenticate the WebSocket server's certificates\nmugs-web-simple --server-ca-file=<path>\n\n# Use custom certs for the web UI gateway itself\nmugs-web-simple --private-key-file=<path> --certificate-file=<path>\n\n# Turn off TLS to the web browser (serving only unencrypted HTTP)\nmugs-web-simple --/secure"}]},{"type":"block","id":"KUmKpvLFrhZ6BO5Zq5hsr","margin":"","level":1,"name":"head","location":{"start":{"line":62,"column":1,"offset":2072},"end":{"line":62,"column":14,"offset":2085}},"content":["DESCRIPTION"]},{"type":"para","id":"mgnj837RtO5thTSQsjxO4","margin":"","location":{"start":{"line":64,"column":1,"offset":2087},"end":{"line":64,"column":90,"offset":2176}},"text":"text","content":[{"type":"fcode","name":"B","content":["NOTE: See the ",{"meta":"https://github.com/Raku-MUGS/MUGS","type":"fcode","name":"L","content":["top-level MUGS repo"]}," for more info."]}]},{"type":"para","id":"Ax4nLp-yl3Gsv1iPFrQK0","margin":"","location":{"start":{"line":66,"column":1,"offset":2178},"end":{"line":66,"column":307,"offset":2484}},"text":"text","content":["MUGS::UI::WebSimple is a Cro-based web gateway for MUGS, including templates and UI plugins to play games from ",{"meta":"https://github.com/Raku-MUGS/MUGS-Core","type":"fcode","name":"L","content":["MUGS-Core"]}," and ",{"meta":"https://github.com/Raku-MUGS/MUGS-Games","type":"fcode","name":"L","content":["MUGS-Games"]}," via a web browser. The WebSimple UI focuses on low-bandwidth, resource-friendly HTML."]},{"type":"para","id":"TZibRbz9kgFWaMrJFWxYu","margin":"","location":{"start":{"line":68,"column":1,"offset":2486},"end":{"line":68,"column":284,"offset":2769}},"text":"text","content":["This Proof-of-Concept release only contains very simple turn-based games, plus a simple front door for creating identities and choosing games to play. Future releases will include many more games and genres, plus better handling of asynchronous events such as inter-player messaging."]},{"type":"block","id":"BAueVQQuXPSo2hL6TsOl9","margin":"","level":1,"name":"head","location":{"start":{"line":70,"column":1,"offset":2771},"end":{"line":70,"column":10,"offset":2780}},"content":["ROADMAP"]},{"type":"para","id":"TM1M9jBNh3fa0Gl5X9CqC","margin":"","location":{"start":{"line":72,"column":1,"offset":2782},"end":{"line":72,"column":339,"offset":3120}},"text":"text","content":["MUGS is still in its infancy, at the beginning of a long and hopefully very enjoyable journey. There is a ",{"meta":"https://github.com/Raku-MUGS/MUGS/tree/main/docs/todo/release-roadmap.md","type":"fcode","name":"L","content":["draft roadmap for the first few major releases"]}," but I don't plan to do it all myself -- I'm looking for contributions of all sorts to help make it a reality."]},{"type":"block","id":"54Eo_LJ1lMI8myqfYT6NB","margin":"","level":1,"name":"head","location":{"start":{"line":74,"column":1,"offset":3122},"end":{"line":74,"column":15,"offset":3136}},"content":["CONTRIBUTING"]},{"type":"para","id":"J4DTMM065XSm_D2bPFIem","margin":"","location":{"start":{"line":76,"column":1,"offset":3138},"end":{"line":76,"column":15,"offset":3152}},"text":"text","content":["Please do! :-)"]},{"type":"para","id":"FBrQzadvikzvXE611DsdX","margin":"","location":{"start":{"line":78,"column":1,"offset":3154},"end":{"line":78,"column":328,"offset":3481}},"text":"text","content":["In all seriousness, check out ",{"meta":"docs/CONTRIBUTING.md","type":"fcode","name":"L","content":["the CONTRIBUTING doc"]}," (identical in each repo) for details on how to contribute, as well as ",{"meta":"https://github.com/Raku-MUGS/MUGS/tree/main/docs/design/coding-standards.md","type":"fcode","name":"L","content":["the Coding Standards doc"]}," for guidelines/standards/rules that apply to code contributions in particular."]},{"type":"para","id":"l8iC6c6t3pFFxRV46XGj8","margin":"","location":{"start":{"line":80,"column":1,"offset":3483},"end":{"line":80,"column":187,"offset":3669}},"text":"text","content":["The MUGS project has a matching GitHub org, ",{"meta":"https://github.com/Raku-MUGS","type":"fcode","name":"L","content":["Raku-MUGS"]},", where you will find all related repositories and issue trackers, as well as formal meta-discussion."]},{"type":"para","id":"Urk6aPYxCuaKQ-fQ0lWJ6","margin":"","location":{"start":{"line":82,"column":1,"offset":3671},"end":{"line":82,"column":102,"offset":3772}},"text":"text","content":["More informal discussion can be found on IRC in ",{"meta":"ircs://chat.freenode.net:6697/mugs","type":"fcode","name":"L","content":["Freenode #mugs"]},"."]},{"type":"block","id":"qAgdYV283IKxIQRdyL_QN","margin":"","level":1,"name":"head","location":{"start":{"line":84,"column":1,"offset":3774},"end":{"line":84,"column":9,"offset":3782}},"content":["AUTHOR"]},{"type":"para","id":"Eal6s_8bjm4bs7W-HU1Uz","margin":"","location":{"start":{"line":86,"column":1,"offset":3784},"end":{"line":86,"column":66,"offset":3849}},"text":"text","content":["Geoffrey Broadwell ",{"meta":"mailto:gjb@sonic.net","type":"fcode","name":"L","content":["gjb@sonic.net"]}," (japhb on GitHub and Freenode)"]},{"type":"block","id":"jvB-W6CpsjuwsqCY0S2Eb","margin":"","level":1,"name":"head","location":{"start":{"line":88,"column":1,"offset":3851},"end":{"line":88,"column":24,"offset":3874}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"5jMve8VPu-8sili3CTbBM","margin":"","location":{"start":{"line":90,"column":1,"offset":3876},"end":{"line":90,"column":34,"offset":3909}},"text":"text","content":["Copyright 2021 Geoffrey Broadwell"]},{"type":"para","id":"rVR555vIo2NZz7sv88_7Q","margin":"","location":{"start":{"line":92,"column":1,"offset":3911},"end":{"line":92,"column":96,"offset":4006}},"text":"text","content":["MUGS is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/MUGS::UI::WebSimple/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:japhb","authors":["Geoffrey Broadwell"],"build-depends":[],"depends":["Cro::HTTP","Cro::WebApp","MUGS::Core:ver<0.0.3>","MUGS::Games:ver<0.0.3>"],"description":"WebSimple UI for MUGS, including HTTP gateway and game UIs","dist":"MUGS::UI::WebSimple:ver<0.0.3>:auth<zef:japhb>","license":"Artistic-2.0","name":"MUGS::UI::WebSimple","path":"M/UG/MUGS_UI_WEBSIMPLE/a067c25aaf1fe19637c4f9984f231ea223b10865.tar.gz","perl":"6.d","provides":{"MUGS::App::WebSimple":"lib/MUGS/App/WebSimple.rakumod","MUGS::App::WebSimple::Routes":"lib/MUGS/App/WebSimple/Routes.rakumod","MUGS::App::WebSimple::Session":"lib/MUGS/App/WebSimple/Session.rakumod","MUGS::UI::WebSimple":"lib/MUGS/UI/WebSimple.rakumod","MUGS::UI::WebSimple::Game::NumberGuess":"lib/MUGS/UI/WebSimple/Game/NumberGuess.rakumod","MUGS::UI::WebSimple::Game::Snowman":"lib/MUGS/UI/WebSimple/Game/Snowman.rakumod","MUGS::UI::WebSimple::Genre::Guessing":"lib/MUGS/UI/WebSimple/Genre/Guessing.rakumod"},"resources":["fake-tls/ca-crt.pem","fake-tls/server-crt.pem","fake-tls/server-key.pem"],"source-url":"https://github.com/Raku-MUGS/MUGS-UI-WebSimple.git","tags":[],"test-depends":[],"version":"0.0.3"},"files":[{"file":"work_mods/zef/MUGS::UI::WebSimple/README.md","publishUrl":"/mods/zef/MUGS::UI::WebSimple/README.md"},{"file":"work_mods/zef/MUGS::UI::WebSimple/CODE_OF_CONDUCT.md","publishUrl":"/mods/zef/MUGS::UI::WebSimple/CODE_OF_CONDUCT.md"},{"file":"work_mods/zef/MUGS::UI::WebSimple/lib/MUGS/UI/WebSimple.rakumod","publishUrl":"/mods/zef/MUGS::UI::WebSimple/lib/MUGS/UI/WebSimple.rakumod"}],"src":"zef","url":"/mods/zef/MUGS::UI::WebSimple"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/MUGS::UI::WebSimple/README.md","sources":[],"node":{"type":"block","id":"n5_AweRPbpYrO99jv5jyH","margin":"","name":"root","content":[{"type":"para","id":"RZOUXlflQirHkkbIcSi6c","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":149,"offset":148}},"text":"text","content":[{"meta":"https://github.com/Raku-MUGS/MUGS-UI-WebSimple/actions","type":"fcode","name":"L","content":[{"type":"block","id":"aU1EzaPu63EG4FRnOrOB9","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":92,"offset":91}},"content":[{"type":"image","src":"https://github.com/Raku-MUGS/MUGS-UI-WebSimple/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"SMN4szi7YRRnypab3OetQ","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":150},"end":{"line":3,"column":7,"offset":156}},"content":["NAME"]},{"type":"para","id":"875AIp7VHrBkHYKJ8cSzB","margin":"","location":{"start":{"line":5,"column":1,"offset":158},"end":{"line":5,"column":79,"offset":236}},"text":"text","content":["MUGS-UI-WebSimple - WebSimple UI for MUGS, including HTTP gateway and game UIs"]},{"type":"block","id":"uUB0Cc1FfjN89k2EvFNjz","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":238},"end":{"line":7,"column":11,"offset":248}},"content":["SYNOPSIS"]},{"type":"block","id":"jghbWOuNt9ovfUz_ewrFr","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":250},"end":{"line":60,"column":30,"offset":2070}},"content":[{"type":"verbatim","value":"# Set up a full-stack MUGS-UI-WebSimple development environment\nmkdir MUGS\ncd MUGS\ngit clone git@github.com:Raku-MUGS/MUGS-Core.git\ngit clone git@github.com:Raku-MUGS/MUGS-Games.git\ngit clone git@github.com:Raku-MUGS/MUGS-UI-WebSimple.git\n\ncd MUGS-Core\nzef install .\nmugs-admin create-universe\n\ncd ../MUGS-Games\nzef install .\n\ncd ../MUGS-UI-WebSimple\n\n\n### GAME SERVER (handles actual gameplay; used by the web UI gateway)\n\n# Start a TLS WebSocket game server on localhost:10000 using fake certs\nmugs-ws-server\n\n# Specify a different MUGS identity universe (defaults to \"default\")\nmugs-ws-server --universe=other-universe\n\n# Start a TLS WebSocket game server on different host:port\nmugs-ws-server --host=<hostname> --port=<portnumber>\n\n# Start a TLS WebSocket game server using custom certs\nmugs-ws-server --private-key-file=<path> --certificate-file=<path>\n\n# Write a Log::Timeline JSON log for the WebSocket server\nLOG_TIMELINE_JSON_LINES=log/mugs-ws-server mugs-ws-server\n\n\n### WEB UI GATEWAY (frontend for a MUGS backend game server)\n\n# Start a web UI gateway on localhost:20000 to play games in a web browser\nmugs-web-simple --server-host=<websocket-host> --server-port=<websocket-port>\nmugs-web-simple --server=<websocket-host>:<websocket-port>\n\n# Start a web UI gateway on a different host:port\nmugs-web-simple --host=<hostname> --port=<portnumber>\n\n# Use a different CA to authenticate the WebSocket server's certificates\nmugs-web-simple --server-ca-file=<path>\n\n# Use custom certs for the web UI gateway itself\nmugs-web-simple --private-key-file=<path> --certificate-file=<path>\n\n# Turn off TLS to the web browser (serving only unencrypted HTTP)\nmugs-web-simple --/secure"}]},{"type":"block","id":"KUmKpvLFrhZ6BO5Zq5hsr","margin":"","level":1,"name":"head","location":{"start":{"line":62,"column":1,"offset":2072},"end":{"line":62,"column":14,"offset":2085}},"content":["DESCRIPTION"]},{"type":"para","id":"mgnj837RtO5thTSQsjxO4","margin":"","location":{"start":{"line":64,"column":1,"offset":2087},"end":{"line":64,"column":90,"offset":2176}},"text":"text","content":[{"type":"fcode","name":"B","content":["NOTE: See the ",{"meta":"https://github.com/Raku-MUGS/MUGS","type":"fcode","name":"L","content":["top-level MUGS repo"]}," for more info."]}]},{"type":"para","id":"Ax4nLp-yl3Gsv1iPFrQK0","margin":"","location":{"start":{"line":66,"column":1,"offset":2178},"end":{"line":66,"column":307,"offset":2484}},"text":"text","content":["MUGS::UI::WebSimple is a Cro-based web gateway for MUGS, including templates and UI plugins to play games from ",{"meta":"https://github.com/Raku-MUGS/MUGS-Core","type":"fcode","name":"L","content":["MUGS-Core"]}," and ",{"meta":"https://github.com/Raku-MUGS/MUGS-Games","type":"fcode","name":"L","content":["MUGS-Games"]}," via a web browser. The WebSimple UI focuses on low-bandwidth, resource-friendly HTML."]},{"type":"para","id":"TZibRbz9kgFWaMrJFWxYu","margin":"","location":{"start":{"line":68,"column":1,"offset":2486},"end":{"line":68,"column":284,"offset":2769}},"text":"text","content":["This Proof-of-Concept release only contains very simple turn-based games, plus a simple front door for creating identities and choosing games to play. Future releases will include many more games and genres, plus better handling of asynchronous events such as inter-player messaging."]},{"type":"block","id":"BAueVQQuXPSo2hL6TsOl9","margin":"","level":1,"name":"head","location":{"start":{"line":70,"column":1,"offset":2771},"end":{"line":70,"column":10,"offset":2780}},"content":["ROADMAP"]},{"type":"para","id":"TM1M9jBNh3fa0Gl5X9CqC","margin":"","location":{"start":{"line":72,"column":1,"offset":2782},"end":{"line":72,"column":339,"offset":3120}},"text":"text","content":["MUGS is still in its infancy, at the beginning of a long and hopefully very enjoyable journey. There is a ",{"meta":"https://github.com/Raku-MUGS/MUGS/tree/main/docs/todo/release-roadmap.md","type":"fcode","name":"L","content":["draft roadmap for the first few major releases"]}," but I don't plan to do it all myself -- I'm looking for contributions of all sorts to help make it a reality."]},{"type":"block","id":"54Eo_LJ1lMI8myqfYT6NB","margin":"","level":1,"name":"head","location":{"start":{"line":74,"column":1,"offset":3122},"end":{"line":74,"column":15,"offset":3136}},"content":["CONTRIBUTING"]},{"type":"para","id":"J4DTMM065XSm_D2bPFIem","margin":"","location":{"start":{"line":76,"column":1,"offset":3138},"end":{"line":76,"column":15,"offset":3152}},"text":"text","content":["Please do! :-)"]},{"type":"para","id":"FBrQzadvikzvXE611DsdX","margin":"","location":{"start":{"line":78,"column":1,"offset":3154},"end":{"line":78,"column":328,"offset":3481}},"text":"text","content":["In all seriousness, check out ",{"meta":"docs/CONTRIBUTING.md","type":"fcode","name":"L","content":["the CONTRIBUTING doc"]}," (identical in each repo) for details on how to contribute, as well as ",{"meta":"https://github.com/Raku-MUGS/MUGS/tree/main/docs/design/coding-standards.md","type":"fcode","name":"L","content":["the Coding Standards doc"]}," for guidelines/standards/rules that apply to code contributions in particular."]},{"type":"para","id":"l8iC6c6t3pFFxRV46XGj8","margin":"","location":{"start":{"line":80,"column":1,"offset":3483},"end":{"line":80,"column":187,"offset":3669}},"text":"text","content":["The MUGS project has a matching GitHub org, ",{"meta":"https://github.com/Raku-MUGS","type":"fcode","name":"L","content":["Raku-MUGS"]},", where you will find all related repositories and issue trackers, as well as formal meta-discussion."]},{"type":"para","id":"Urk6aPYxCuaKQ-fQ0lWJ6","margin":"","location":{"start":{"line":82,"column":1,"offset":3671},"end":{"line":82,"column":102,"offset":3772}},"text":"text","content":["More informal discussion can be found on IRC in ",{"meta":"ircs://chat.freenode.net:6697/mugs","type":"fcode","name":"L","content":["Freenode #mugs"]},"."]},{"type":"block","id":"qAgdYV283IKxIQRdyL_QN","margin":"","level":1,"name":"head","location":{"start":{"line":84,"column":1,"offset":3774},"end":{"line":84,"column":9,"offset":3782}},"content":["AUTHOR"]},{"type":"para","id":"Eal6s_8bjm4bs7W-HU1Uz","margin":"","location":{"start":{"line":86,"column":1,"offset":3784},"end":{"line":86,"column":66,"offset":3849}},"text":"text","content":["Geoffrey Broadwell ",{"meta":"mailto:gjb@sonic.net","type":"fcode","name":"L","content":["gjb@sonic.net"]}," (japhb on GitHub and Freenode)"]},{"type":"block","id":"jvB-W6CpsjuwsqCY0S2Eb","margin":"","level":1,"name":"head","location":{"start":{"line":88,"column":1,"offset":3851},"end":{"line":88,"column":24,"offset":3874}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"5jMve8VPu-8sili3CTbBM","margin":"","location":{"start":{"line":90,"column":1,"offset":3876},"end":{"line":90,"column":34,"offset":3909}},"text":"text","content":["Copyright 2021 Geoffrey Broadwell"]},{"type":"para","id":"rVR555vIo2NZz7sv88_7Q","margin":"","location":{"start":{"line":92,"column":1,"offset":3911},"end":{"line":92,"column":96,"offset":4006}},"text":"text","content":["MUGS is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/MUGS::UI::WebSimple/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:japhb","authors":["Geoffrey Broadwell"],"build-depends":[],"depends":["Cro::HTTP","Cro::WebApp","MUGS::Core:ver<0.0.3>","MUGS::Games:ver<0.0.3>"],"description":"WebSimple UI for MUGS, including HTTP gateway and game UIs","dist":"MUGS::UI::WebSimple:ver<0.0.3>:auth<zef:japhb>","license":"Artistic-2.0","name":"MUGS::UI::WebSimple","path":"M/UG/MUGS_UI_WEBSIMPLE/a067c25aaf1fe19637c4f9984f231ea223b10865.tar.gz","perl":"6.d","provides":{"MUGS::App::WebSimple":"lib/MUGS/App/WebSimple.rakumod","MUGS::App::WebSimple::Routes":"lib/MUGS/App/WebSimple/Routes.rakumod","MUGS::App::WebSimple::Session":"lib/MUGS/App/WebSimple/Session.rakumod","MUGS::UI::WebSimple":"lib/MUGS/UI/WebSimple.rakumod","MUGS::UI::WebSimple::Game::NumberGuess":"lib/MUGS/UI/WebSimple/Game/NumberGuess.rakumod","MUGS::UI::WebSimple::Game::Snowman":"lib/MUGS/UI/WebSimple/Game/Snowman.rakumod","MUGS::UI::WebSimple::Genre::Guessing":"lib/MUGS/UI/WebSimple/Genre/Guessing.rakumod"},"resources":["fake-tls/ca-crt.pem","fake-tls/server-crt.pem","fake-tls/server-key.pem"],"source-url":"https://github.com/Raku-MUGS/MUGS-UI-WebSimple.git","tags":[],"test-depends":[],"version":"0.0.3"},"files":[{"file":"work_mods/zef/MUGS::UI::WebSimple/README.md","publishUrl":"/mods/zef/MUGS::UI::WebSimple/README.md"},{"file":"work_mods/zef/MUGS::UI::WebSimple/CODE_OF_CONDUCT.md","publishUrl":"/mods/zef/MUGS::UI::WebSimple/CODE_OF_CONDUCT.md"},{"file":"work_mods/zef/MUGS::UI::WebSimple/lib/MUGS/UI/WebSimple.rakumod","publishUrl":"/mods/zef/MUGS::UI::WebSimple/lib/MUGS/UI/WebSimple.rakumod"}],"src":"zef","url":"/mods/zef/MUGS::UI::WebSimple"}}}
    =end data
    =end React


MUGS::UI::WebSimple


CLI UI for MUGS, including App and game UIs


=begin data
{"type":"page","file":"work_mods/zef/MUGS::UI::CLI/README.md","sources":[],"node":{"type":"block","id":"z9bbLHSUFLX_MNihMEvSO","margin":"","name":"root","content":[{"type":"para","id":"ag9iojWpgfwEFoxzby2A2","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":137,"offset":136}},"text":"text","content":[{"meta":"https://github.com/Raku-MUGS/MUGS-UI-CLI/actions","type":"fcode","name":"L","content":[{"type":"block","id":"ngsELZptHKfEgo-sJeKwK","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":86,"offset":85}},"content":[{"type":"image","src":"https://github.com/Raku-MUGS/MUGS-UI-CLI/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"5_2tvkL_jJTKQeafgHlak","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":138},"end":{"line":3,"column":7,"offset":144}},"content":["NAME"]},{"type":"para","id":"-aWXtYUiITzfaZGyTHZMw","margin":"","location":{"start":{"line":5,"column":1,"offset":146},"end":{"line":5,"column":58,"offset":203}},"text":"text","content":["MUGS-UI-CLI - CLI UI for MUGS, including App and game UIs"]},{"type":"block","id":"JI9kMhPAtcB-G0E9kEXpP","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":205},"end":{"line":7,"column":11,"offset":215}},"content":["SYNOPSIS"]},{"type":"block","id":"ZfL_tOi33G2toeU5YEN5S","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":217},"end":{"line":53,"column":62,"offset":1597}},"content":[{"type":"verbatim","value":"# Set up a full-stack MUGS-UI-CLI development environment\nmkdir MUGS\ncd MUGS\ngit clone git@github.com:Raku-MUGS/MUGS-Core.git\ngit clone git@github.com:Raku-MUGS/MUGS-Games.git\ngit clone git@github.com:Raku-MUGS/MUGS-UI-CLI.git\n\ncd MUGS-Core\nzef install .\nmugs-admin create-universe\n\ncd ../MUGS-Games\nzef install .\n\ncd ../MUGS-UI-CLI\n\n\n### LOCAL PLAY\n\n# Play games using a local CLI UI, using an internal stub server and ephemeral data\nmugs-cli\n\n# Play games using an internal stub server accessing the long-lived data set\nmugs-cli --universe=<universe-name>  # 'default' if set up as above\n\n# Log in and play games on a WebSocket server using a local CLI UI\nmugs-cli --server=<host>:<port>\n\n\n### GAME SERVERS\n\n# Start a TLS WebSocket game server on localhost:10000 using fake certs\nmugs-ws-server\n\n# Specify a different MUGS identity universe (defaults to \"default\")\nmugs-ws-server --universe=other-universe\n\n# Start a TLS WebSocket game server on different host:port\nmugs-ws-server --host=<hostname> --port=<portnumber>\n\n# Start a TLS WebSocket game server using custom certs\nmugs-ws-server --private-key-file=<path> --certificate-file=<path>\n\n# Write a Log::Timeline JSON log for the WebSocket server\nLOG_TIMELINE_JSON_LINES=log/mugs-ws-server mugs-ws-server"}]},{"type":"block","id":"3JBhwEXBpRZwdVg1YwyJ2","margin":"","level":1,"name":"head","location":{"start":{"line":55,"column":1,"offset":1599},"end":{"line":55,"column":14,"offset":1612}},"content":["DESCRIPTION"]},{"type":"para","id":"fYE9HGPjGa2UmzGwHUghL","margin":"","location":{"start":{"line":57,"column":1,"offset":1614},"end":{"line":57,"column":90,"offset":1703}},"text":"text","content":[{"type":"fcode","name":"B","content":["NOTE: See the ",{"meta":"https://github.com/Raku-MUGS/MUGS","type":"fcode","name":"L","content":["top-level MUGS repo"]}," for more info."]}]},{"type":"para","id":"zFOiWyVjbrPR0xFMnGfY9","margin":"","location":{"start":{"line":59,"column":1,"offset":1705},"end":{"line":59,"column":216,"offset":1920}},"text":"text","content":["MUGS::UI::CLI is a CLI app (",{"type":"fcode","name":"C","content":["mugs-cli"]},") and a set of UI plugins to play each of the games in ",{"meta":"https://github.com/Raku-MUGS/MUGS-Core","type":"fcode","name":"L","content":["MUGS-Core"]}," and ",{"meta":"https://github.com/Raku-MUGS/MUGS-Games","type":"fcode","name":"L","content":["MUGS-Games"]}," via the CLI."]},{"type":"para","id":"vg1MCbx1EwkHK8BznVwF-","margin":"","location":{"start":{"line":61,"column":1,"offset":1922},"end":{"line":61,"column":312,"offset":2233}},"text":"text","content":["This Proof-of-Concept release only contains very simple turn-based guessing and interactive fiction games, plus a simple lobby for creating identities and choosing games to play. Future releases will include many more games and genres, plus better handling of asynchronous events such as inter-player messaging."]},{"type":"block","id":"ZdP6jVS3gFCihtGb8CrXt","margin":"","level":1,"name":"head","location":{"start":{"line":63,"column":1,"offset":2235},"end":{"line":63,"column":10,"offset":2244}},"content":["ROADMAP"]},{"type":"para","id":"X4BsaxnlPZ5oD8fpyYQjQ","margin":"","location":{"start":{"line":65,"column":1,"offset":2246},"end":{"line":65,"column":339,"offset":2584}},"text":"text","content":["MUGS is still in its infancy, at the beginning of a long and hopefully very enjoyable journey. There is a ",{"meta":"https://github.com/Raku-MUGS/MUGS/tree/main/docs/todo/release-roadmap.md","type":"fcode","name":"L","content":["draft roadmap for the first few major releases"]}," but I don't plan to do it all myself -- I'm looking for contributions of all sorts to help make it a reality."]},{"type":"block","id":"Z2IAlUa3quPTevw6PIJ-j","margin":"","level":1,"name":"head","location":{"start":{"line":67,"column":1,"offset":2586},"end":{"line":67,"column":15,"offset":2600}},"content":["CONTRIBUTING"]},{"type":"para","id":"dljez-i7UbN2lUdQhd0di","margin":"","location":{"start":{"line":69,"column":1,"offset":2602},"end":{"line":69,"column":15,"offset":2616}},"text":"text","content":["Please do! :-)"]},{"type":"para","id":"NX312HWsZFPPLR548MKB9","margin":"","location":{"start":{"line":71,"column":1,"offset":2618},"end":{"line":71,"column":328,"offset":2945}},"text":"text","content":["In all seriousness, check out ",{"meta":"docs/CONTRIBUTING.md","type":"fcode","name":"L","content":["the CONTRIBUTING doc"]}," (identical in each repo) for details on how to contribute, as well as ",{"meta":"https://github.com/Raku-MUGS/MUGS/tree/main/docs/design/coding-standards.md","type":"fcode","name":"L","content":["the Coding Standards doc"]}," for guidelines/standards/rules that apply to code contributions in particular."]},{"type":"para","id":"8vuZ4YkdHLGujB7Q2vIUi","margin":"","location":{"start":{"line":73,"column":1,"offset":2947},"end":{"line":73,"column":187,"offset":3133}},"text":"text","content":["The MUGS project has a matching GitHub org, ",{"meta":"https://github.com/Raku-MUGS","type":"fcode","name":"L","content":["Raku-MUGS"]},", where you will find all related repositories and issue trackers, as well as formal meta-discussion."]},{"type":"para","id":"50_LV4DDmzjK4KUtixTHm","margin":"","location":{"start":{"line":75,"column":1,"offset":3135},"end":{"line":75,"column":102,"offset":3236}},"text":"text","content":["More informal discussion can be found on IRC in ",{"meta":"ircs://chat.freenode.net:6697/mugs","type":"fcode","name":"L","content":["Freenode #mugs"]},"."]},{"type":"block","id":"b0ApIxjQXbzypLut0BLDO","margin":"","level":1,"name":"head","location":{"start":{"line":77,"column":1,"offset":3238},"end":{"line":77,"column":9,"offset":3246}},"content":["AUTHOR"]},{"type":"para","id":"st72RxW68gczkoU9xxGMv","margin":"","location":{"start":{"line":79,"column":1,"offset":3248},"end":{"line":79,"column":66,"offset":3313}},"text":"text","content":["Geoffrey Broadwell ",{"meta":"mailto:gjb@sonic.net","type":"fcode","name":"L","content":["gjb@sonic.net"]}," (japhb on GitHub and Freenode)"]},{"type":"block","id":"FX0p2mYB0NMXSc1BJncWm","margin":"","level":1,"name":"head","location":{"start":{"line":81,"column":1,"offset":3315},"end":{"line":81,"column":24,"offset":3338}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"1yeS-GFc8wDbvRMd7Hb5S","margin":"","location":{"start":{"line":83,"column":1,"offset":3340},"end":{"line":83,"column":34,"offset":3373}},"text":"text","content":["Copyright 2021 Geoffrey Broadwell"]},{"type":"para","id":"suhRyjvgT3yccKeqQUieP","margin":"","location":{"start":{"line":85,"column":1,"offset":3375},"end":{"line":85,"column":96,"offset":3470}},"text":"text","content":["MUGS is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/MUGS::UI::CLI/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:japhb","authors":["Geoffrey Broadwell"],"build-depends":[],"depends":["MUGS::Core:ver<0.0.3>","MUGS::Games:ver<0.0.3>","Term::termios","Terminal::ANSIColor","Text::MiscUtils::Layout"],"description":"CLI UI for MUGS, including App and game UIs","dist":"MUGS::UI::CLI:ver<0.0.3>:auth<zef:japhb>","license":"Artistic-2.0","name":"MUGS::UI::CLI","path":"M/UG/MUGS_UI_CLI/c256f957b4d80869b2dcc4e3d7161144ceb5d2f7.tar.gz","perl":"6.d","provides":{"MUGS::App::CLI":"lib/MUGS/App/CLI.rakumod","MUGS::UI::CLI":"lib/MUGS/UI/CLI.rakumod","MUGS::UI::CLI::Game::Adventure":"lib/MUGS/UI/CLI/Game/Adventure.rakumod","MUGS::UI::CLI::Game::Echo":"lib/MUGS/UI/CLI/Game/Echo.rakumod","MUGS::UI::CLI::Game::Lobby":"lib/MUGS/UI/CLI/Game/Lobby.rakumod","MUGS::UI::CLI::Game::NumberGuess":"lib/MUGS/UI/CLI/Game/NumberGuess.rakumod","MUGS::UI::CLI::Game::Snowman":"lib/MUGS/UI/CLI/Game/Snowman.rakumod","MUGS::UI::CLI::Genre::Guessing":"lib/MUGS/UI/CLI/Genre/Guessing.rakumod","MUGS::UI::CLI::Genre::IF":"lib/MUGS/UI/CLI/Genre/IF.rakumod","MUGS::UI::CLI::Genre::Test":"lib/MUGS/UI/CLI/Genre/Test.rakumod","MUGS::UI::CLI::Input":"lib/MUGS/UI/CLI/Input.rakumod"},"resources":[],"source-url":"https://github.com/Raku-MUGS/MUGS-UI-CLI.git","tags":[],"test-depends":[],"version":"0.0.3"},"files":[{"file":"work_mods/zef/MUGS::UI::CLI/README.md","publishUrl":"/mods/zef/MUGS::UI::CLI/README.md"},{"file":"work_mods/zef/MUGS::UI::CLI/CODE_OF_CONDUCT.md","publishUrl":"/mods/zef/MUGS::UI::CLI/CODE_OF_CONDUCT.md"},{"file":"work_mods/zef/MUGS::UI::CLI/docs/CONTRIBUTING.md","publishUrl":"/mods/zef/MUGS::UI::CLI/docs/CONTRIBUTING.md"},{"file":"work_mods/zef/MUGS::UI::CLI/lib/MUGS/UI/CLI.rakumod","publishUrl":"/mods/zef/MUGS::UI::CLI/lib/MUGS/UI/CLI.rakumod"}],"src":"zef","url":"/mods/zef/MUGS::UI::CLI"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/MUGS::UI::CLI/README.md","sources":[],"node":{"type":"block","id":"z9bbLHSUFLX_MNihMEvSO","margin":"","name":"root","content":[{"type":"para","id":"ag9iojWpgfwEFoxzby2A2","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":137,"offset":136}},"text":"text","content":[{"meta":"https://github.com/Raku-MUGS/MUGS-UI-CLI/actions","type":"fcode","name":"L","content":[{"type":"block","id":"ngsELZptHKfEgo-sJeKwK","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":86,"offset":85}},"content":[{"type":"image","src":"https://github.com/Raku-MUGS/MUGS-UI-CLI/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"5_2tvkL_jJTKQeafgHlak","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":138},"end":{"line":3,"column":7,"offset":144}},"content":["NAME"]},{"type":"para","id":"-aWXtYUiITzfaZGyTHZMw","margin":"","location":{"start":{"line":5,"column":1,"offset":146},"end":{"line":5,"column":58,"offset":203}},"text":"text","content":["MUGS-UI-CLI - CLI UI for MUGS, including App and game UIs"]},{"type":"block","id":"JI9kMhPAtcB-G0E9kEXpP","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":205},"end":{"line":7,"column":11,"offset":215}},"content":["SYNOPSIS"]},{"type":"block","id":"ZfL_tOi33G2toeU5YEN5S","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":217},"end":{"line":53,"column":62,"offset":1597}},"content":[{"type":"verbatim","value":"# Set up a full-stack MUGS-UI-CLI development environment\nmkdir MUGS\ncd MUGS\ngit clone git@github.com:Raku-MUGS/MUGS-Core.git\ngit clone git@github.com:Raku-MUGS/MUGS-Games.git\ngit clone git@github.com:Raku-MUGS/MUGS-UI-CLI.git\n\ncd MUGS-Core\nzef install .\nmugs-admin create-universe\n\ncd ../MUGS-Games\nzef install .\n\ncd ../MUGS-UI-CLI\n\n\n### LOCAL PLAY\n\n# Play games using a local CLI UI, using an internal stub server and ephemeral data\nmugs-cli\n\n# Play games using an internal stub server accessing the long-lived data set\nmugs-cli --universe=<universe-name>  # 'default' if set up as above\n\n# Log in and play games on a WebSocket server using a local CLI UI\nmugs-cli --server=<host>:<port>\n\n\n### GAME SERVERS\n\n# Start a TLS WebSocket game server on localhost:10000 using fake certs\nmugs-ws-server\n\n# Specify a different MUGS identity universe (defaults to \"default\")\nmugs-ws-server --universe=other-universe\n\n# Start a TLS WebSocket game server on different host:port\nmugs-ws-server --host=<hostname> --port=<portnumber>\n\n# Start a TLS WebSocket game server using custom certs\nmugs-ws-server --private-key-file=<path> --certificate-file=<path>\n\n# Write a Log::Timeline JSON log for the WebSocket server\nLOG_TIMELINE_JSON_LINES=log/mugs-ws-server mugs-ws-server"}]},{"type":"block","id":"3JBhwEXBpRZwdVg1YwyJ2","margin":"","level":1,"name":"head","location":{"start":{"line":55,"column":1,"offset":1599},"end":{"line":55,"column":14,"offset":1612}},"content":["DESCRIPTION"]},{"type":"para","id":"fYE9HGPjGa2UmzGwHUghL","margin":"","location":{"start":{"line":57,"column":1,"offset":1614},"end":{"line":57,"column":90,"offset":1703}},"text":"text","content":[{"type":"fcode","name":"B","content":["NOTE: See the ",{"meta":"https://github.com/Raku-MUGS/MUGS","type":"fcode","name":"L","content":["top-level MUGS repo"]}," for more info."]}]},{"type":"para","id":"zFOiWyVjbrPR0xFMnGfY9","margin":"","location":{"start":{"line":59,"column":1,"offset":1705},"end":{"line":59,"column":216,"offset":1920}},"text":"text","content":["MUGS::UI::CLI is a CLI app (",{"type":"fcode","name":"C","content":["mugs-cli"]},") and a set of UI plugins to play each of the games in ",{"meta":"https://github.com/Raku-MUGS/MUGS-Core","type":"fcode","name":"L","content":["MUGS-Core"]}," and ",{"meta":"https://github.com/Raku-MUGS/MUGS-Games","type":"fcode","name":"L","content":["MUGS-Games"]}," via the CLI."]},{"type":"para","id":"vg1MCbx1EwkHK8BznVwF-","margin":"","location":{"start":{"line":61,"column":1,"offset":1922},"end":{"line":61,"column":312,"offset":2233}},"text":"text","content":["This Proof-of-Concept release only contains very simple turn-based guessing and interactive fiction games, plus a simple lobby for creating identities and choosing games to play. Future releases will include many more games and genres, plus better handling of asynchronous events such as inter-player messaging."]},{"type":"block","id":"ZdP6jVS3gFCihtGb8CrXt","margin":"","level":1,"name":"head","location":{"start":{"line":63,"column":1,"offset":2235},"end":{"line":63,"column":10,"offset":2244}},"content":["ROADMAP"]},{"type":"para","id":"X4BsaxnlPZ5oD8fpyYQjQ","margin":"","location":{"start":{"line":65,"column":1,"offset":2246},"end":{"line":65,"column":339,"offset":2584}},"text":"text","content":["MUGS is still in its infancy, at the beginning of a long and hopefully very enjoyable journey. There is a ",{"meta":"https://github.com/Raku-MUGS/MUGS/tree/main/docs/todo/release-roadmap.md","type":"fcode","name":"L","content":["draft roadmap for the first few major releases"]}," but I don't plan to do it all myself -- I'm looking for contributions of all sorts to help make it a reality."]},{"type":"block","id":"Z2IAlUa3quPTevw6PIJ-j","margin":"","level":1,"name":"head","location":{"start":{"line":67,"column":1,"offset":2586},"end":{"line":67,"column":15,"offset":2600}},"content":["CONTRIBUTING"]},{"type":"para","id":"dljez-i7UbN2lUdQhd0di","margin":"","location":{"start":{"line":69,"column":1,"offset":2602},"end":{"line":69,"column":15,"offset":2616}},"text":"text","content":["Please do! :-)"]},{"type":"para","id":"NX312HWsZFPPLR548MKB9","margin":"","location":{"start":{"line":71,"column":1,"offset":2618},"end":{"line":71,"column":328,"offset":2945}},"text":"text","content":["In all seriousness, check out ",{"meta":"docs/CONTRIBUTING.md","type":"fcode","name":"L","content":["the CONTRIBUTING doc"]}," (identical in each repo) for details on how to contribute, as well as ",{"meta":"https://github.com/Raku-MUGS/MUGS/tree/main/docs/design/coding-standards.md","type":"fcode","name":"L","content":["the Coding Standards doc"]}," for guidelines/standards/rules that apply to code contributions in particular."]},{"type":"para","id":"8vuZ4YkdHLGujB7Q2vIUi","margin":"","location":{"start":{"line":73,"column":1,"offset":2947},"end":{"line":73,"column":187,"offset":3133}},"text":"text","content":["The MUGS project has a matching GitHub org, ",{"meta":"https://github.com/Raku-MUGS","type":"fcode","name":"L","content":["Raku-MUGS"]},", where you will find all related repositories and issue trackers, as well as formal meta-discussion."]},{"type":"para","id":"50_LV4DDmzjK4KUtixTHm","margin":"","location":{"start":{"line":75,"column":1,"offset":3135},"end":{"line":75,"column":102,"offset":3236}},"text":"text","content":["More informal discussion can be found on IRC in ",{"meta":"ircs://chat.freenode.net:6697/mugs","type":"fcode","name":"L","content":["Freenode #mugs"]},"."]},{"type":"block","id":"b0ApIxjQXbzypLut0BLDO","margin":"","level":1,"name":"head","location":{"start":{"line":77,"column":1,"offset":3238},"end":{"line":77,"column":9,"offset":3246}},"content":["AUTHOR"]},{"type":"para","id":"st72RxW68gczkoU9xxGMv","margin":"","location":{"start":{"line":79,"column":1,"offset":3248},"end":{"line":79,"column":66,"offset":3313}},"text":"text","content":["Geoffrey Broadwell ",{"meta":"mailto:gjb@sonic.net","type":"fcode","name":"L","content":["gjb@sonic.net"]}," (japhb on GitHub and Freenode)"]},{"type":"block","id":"FX0p2mYB0NMXSc1BJncWm","margin":"","level":1,"name":"head","location":{"start":{"line":81,"column":1,"offset":3315},"end":{"line":81,"column":24,"offset":3338}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"1yeS-GFc8wDbvRMd7Hb5S","margin":"","location":{"start":{"line":83,"column":1,"offset":3340},"end":{"line":83,"column":34,"offset":3373}},"text":"text","content":["Copyright 2021 Geoffrey Broadwell"]},{"type":"para","id":"suhRyjvgT3yccKeqQUieP","margin":"","location":{"start":{"line":85,"column":1,"offset":3375},"end":{"line":85,"column":96,"offset":3470}},"text":"text","content":["MUGS is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/MUGS::UI::CLI/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:japhb","authors":["Geoffrey Broadwell"],"build-depends":[],"depends":["MUGS::Core:ver<0.0.3>","MUGS::Games:ver<0.0.3>","Term::termios","Terminal::ANSIColor","Text::MiscUtils::Layout"],"description":"CLI UI for MUGS, including App and game UIs","dist":"MUGS::UI::CLI:ver<0.0.3>:auth<zef:japhb>","license":"Artistic-2.0","name":"MUGS::UI::CLI","path":"M/UG/MUGS_UI_CLI/c256f957b4d80869b2dcc4e3d7161144ceb5d2f7.tar.gz","perl":"6.d","provides":{"MUGS::App::CLI":"lib/MUGS/App/CLI.rakumod","MUGS::UI::CLI":"lib/MUGS/UI/CLI.rakumod","MUGS::UI::CLI::Game::Adventure":"lib/MUGS/UI/CLI/Game/Adventure.rakumod","MUGS::UI::CLI::Game::Echo":"lib/MUGS/UI/CLI/Game/Echo.rakumod","MUGS::UI::CLI::Game::Lobby":"lib/MUGS/UI/CLI/Game/Lobby.rakumod","MUGS::UI::CLI::Game::NumberGuess":"lib/MUGS/UI/CLI/Game/NumberGuess.rakumod","MUGS::UI::CLI::Game::Snowman":"lib/MUGS/UI/CLI/Game/Snowman.rakumod","MUGS::UI::CLI::Genre::Guessing":"lib/MUGS/UI/CLI/Genre/Guessing.rakumod","MUGS::UI::CLI::Genre::IF":"lib/MUGS/UI/CLI/Genre/IF.rakumod","MUGS::UI::CLI::Genre::Test":"lib/MUGS/UI/CLI/Genre/Test.rakumod","MUGS::UI::CLI::Input":"lib/MUGS/UI/CLI/Input.rakumod"},"resources":[],"source-url":"https://github.com/Raku-MUGS/MUGS-UI-CLI.git","tags":[],"test-depends":[],"version":"0.0.3"},"files":[{"file":"work_mods/zef/MUGS::UI::CLI/README.md","publishUrl":"/mods/zef/MUGS::UI::CLI/README.md"},{"file":"work_mods/zef/MUGS::UI::CLI/CODE_OF_CONDUCT.md","publishUrl":"/mods/zef/MUGS::UI::CLI/CODE_OF_CONDUCT.md"},{"file":"work_mods/zef/MUGS::UI::CLI/docs/CONTRIBUTING.md","publishUrl":"/mods/zef/MUGS::UI::CLI/docs/CONTRIBUTING.md"},{"file":"work_mods/zef/MUGS::UI::CLI/lib/MUGS/UI/CLI.rakumod","publishUrl":"/mods/zef/MUGS::UI::CLI/lib/MUGS/UI/CLI.rakumod"}],"src":"zef","url":"/mods/zef/MUGS::UI::CLI"}}}
    =end data
    =end React


MUGS::UI::CLI


The Raku Knowledge Base


=begin React :component<HeaderCol> :id<footer>  
=begin nested :!nested
=item1 B<Language>
    =item2 L<Get started|file:../getting-started/getting-started.podlite>
    =item2 L<Why Raku?|/doc/language/faq#Why-should-I-learn-Raku-What's-so-great-about-it>
    =item2 L<Try Raku|https://glot.io/new/raku>
    =item2 L<Raku cheat sheet|https://github.com/Raku/mu/blob/master/docs/Perl6/Cheatsheet/cheatsheet.txt>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<Raku on Exercism|https://exercism.org/tracks/raku>
    =item2 L<Wikipedia|https://en.wikipedia.org/wiki/Raku_(programming_language)>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=begin nested :!nested

=item1 B<L<Documentation|/doc>>
    =item2 L<Getting started, Migration guides from other languages, & Tutorials | file:../doc/introduction.podlite>
    =item2 L<Language References|file:../doc/reference.podlite>
    =item2 L<Type Reference| file:../doc/types.podlite>
    =item2 L<Miscellaneous| file:../doc/miscellaneous.podlite>
    =item2 L<FAQs (Frequently Asked Questions)|/doc/language/faq>
    =item2 L<Community|/doc/language/community>
    =item2 L<The list of all documents|file:../doc/index.podlite>

=item1 B<Resources>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>

=end nested
=begin nested :!nested

=item1 B<Resoures>
    =item2 L<Download | file:../download/index.podlite>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=item1 B<Learning>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Wikibook |https://en.wikibooks.org/wiki/Raku_Programming>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>
    =item2 L<Learn Raku in Y minutes|https://learnxinyminutes.com/docs/raku/>
    =item2 L<Golfing |https://github.com/AlexDaniel/raku-golf-cheatsheet>
=end nested
=begin nested :!nested

=item1 B<Explore>
    =item2 L<Raku Blog Aggregator|https://planet.raku.org/>
    =item2 L<Rakudo Weekly|https://rakudoweekly.blog/>
    =item2 L<The Weekly Challenge |https://perlweeklychallenge.org/>
    =item2 L<Raku Advent Calendar|https://raku-advent.blog/>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=end React


=begin React :component<CookieConsent> :id<CookieConsent> :buttonCaption("Got it!")
=para
This website uses cookies for analytics.
=end React


MUGS::UI::TUI

NAME

SYNOPSIS

DESCRIPTION

AUTHOR

COPYRIGHT AND LICENSE

MUGS::UI::TUI v0.1.0

Authors

License

Dependencies

Test Dependencies

Provides

Documentation