An infrastructure-as-code and deployment tool for Roblox.
It is recommended to install with Foreman, with the following config:
# foreman.toml
[tools]
mantle = { source = "blake-mealey/mantle", version = "0.9.0" }
You can learn more about Foreman including how to install it from its documentation.
Check out the docs site for more info.
I'm running 0.11.1 but it seems like this is affecting all versions of Mantle.
Deploying resources:
╷
│ ~ Updating: placeFile_start
│ ╷
│ │ Dependencies:
│ │ - place:
│ │ assetId: XXXXXXXXX
│ │ Inputs:
│ │ placeFile:
│ │ filePath: game.rbxlx
│ │ - fileHash: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
│ │ + fileHash: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
│ │
│ ╰─ Failed: Unknown error (status 404 Not Found)
│
│
╰─ Failed 1 changes(s) while evaluating the resource graph. See above for more details.
Personal assumption is that this is caused by Roblox's recent removal of api.roblox.com and www.roblox.com endpoints.
When deploying with a configuration that has multiple places in an experience, any places that are not the starting place fail during creation. The resulting error message is HTML for a generic Roblox error page. A new place is actually created on the website during this process, but the steps to upload the place file and apply the configuration are skipped.
I had to pipe the output into a text file because the HTML was too long for my terminal
The program then goes on to skip the file upload & configuration steps for the place that failed, but successfully creates the starting place.
Describe the bug When updating a game pass icon, Mantle errors with a 404 Not Found.
To Reproduce Steps to reproduce the behavior:
Expected behavior The icon is correctly updated.
Environment (please complete the following information):
Additional context
It looks like this is because of the usage of POST https://publish.roblox.com/v1/game-passes/:gamePassId/icon, which does not seem to exist (tested this with Postman).
https://github.com/blake-mealey/mantle/blob/0adfb6333ed5f0f8e96260d73cee99d09c07ef70/rbx_mantle/src/roblox_api.rs#L1536
When manually updating the game pass icon and checking the browser logs, only one request is made and this is to https://www.roblox.com/game-pass/update, same as in update_game_pass:
https://github.com/blake-mealey/mantle/blob/0adfb6333ed5f0f8e96260d73cee99d09c07ef70/rbx_mantle/src/roblox_api.rs#L1514
When the game pass icon is changed, this request is encoded as gzip and includes the new image.
bugI am getting 413 Payload Too Large errors when running mantle deploy.
The place I'm trying to upload is ~650 MB. If this is me hitting the endpoint's limits, are there any alternatives I can use?
bug questionContext: https://devforum.roblox.com/t/action-needed-sunsetting-apirobloxcom/1796897
Affected endpoints we currently use:
Currently none of these endpoints actually has a replacement we can use. They linked to Develop Api for one but there is no analogous API there.
roblox api deprecation nextWhat type of feature request is this? Mantle doesn't support a Roblox feature I would like to use
Currently I have to manually give every audio asset uploaded access to the proper universe ID for them to play ingame without publishing a build, Ideally mantle should handle this for me, current workaround is going through every audio asset in the asset manager after deploying and clicking this in the output.
(DRAFT)
~Experience icon:~
~Experience thumbnails:~
~Experience developer products:~
~Experience badges:~ added in #59
~Experience game passes:~ added in #45
~Experiences:~
isArchived: true~ added in #39~Places:~
Assets (images, audio, etc):
Config:
target:
experience:
configuration:
spatialVoiceEnabled: true # defaults to `false`
This is managed via a separate API surface so it will need a new resource type under the hood:
spatialVoiceConfigurationPOST https://voice.roblox.com/v1/settings/universe/{experienceId}
{ "optIn": boolean }GET https://voice.roblox.com/v1/settings/universe/{experienceId}
{ "isUniverseEnabledForVoice": boolean }The design of the roblox API suggests to me that there will be more settings in the future for how spatial voice is configured. Until then I think this API is fine, but in the future we might refactor to something like:
target:
experience:
spacialVoice:
enabled: true
someOtherSetting: false
The outputs command currently dumps to a JSON file which is not directly usable by anything. The primary use case I see for the outputs file is for automated consumption by Rojo projects. Therefore, there should be a way to produce a file that is Rojo-supported.
Additionally, we may need to consider splitting place file uploads from the rest of the deployment phase (e.g. mantle prepare and mantle publish) so that we can avoid the chicken-and-egg problem here.
Since #16, Tokio has been added for making asynchronous requests to AWS. We can use this to improve the performance of deploys by parallelizing Roblox API requests. We will have to run the requests in batches and only run the next N requests which are not dependent on each other.
enhancement code qualityReported in the discord:
Run: mantle --version
Outputs: error while loading shared libraries: libssl.so.3: cannot open shared object file: No such file or directory
What type of feature request is this?
Describe your problem There is a per-account monthly audio limit of 10 sounds without ID verification, or 100 sounds with ID verification. Describe the solution you'd like I'd like to be able to pass multiple ROBLOSECURITY tokens to Mantle. When one token lacks permission or upload capacity, another would be used.
enhancementWhat type of feature request is this?
Describe your problem Currently Mantle doesn't support loading remote state credentials without modifying your system user's AWS credentials file. This isn't scoped to the project you're working on and is a bit cumbersome.
Describe the solution you'd like
It would be great if Mantle could support loading remote state credentials (and any other environment-specific settings) via the industry-standard .env file.
Additionally, prefixing .env variable names with MANTLE_ would allow other tools in the project to use different sets of AWS credentials.
What type of feature request is this?
Describe your problem
New feature: https://devforum.roblox.com/t/alt-text-for-experience-thumbnails/2066564
Describe the solution you'd like
Add an option for thumbnail alt text
enhancementWhat type of feature request is this? Mantle doesn't support a Roblox feature I would like to use
I'd like mantle to support configuring "Allow this place to be copied as a template using the Create Place API in your experience." and "Allow this place to be updated using the Save Place API in your experience."
These settings are used to create games that create brand new Roblox places from a "template" place, which is a feature used in a few building games to persist players builds
What type of feature request is this?
Describe your problem Sometimes Roblox APIs fail with no meaningful reason, e.g. this integration test run: https://github.com/blake-mealey/mantle/runs/6960870004?check_suite_focus=true
Describe the solution you'd like Mantle could automatically retry failed requests 1 or 2 times when the status code was 500.
enhancementWhat type of feature request is this?
Describe your problem The current environment overrides configuration options are limited and require lots of boilerplate which makes it harder to read.
The targetOverrides provides full flexibility at the cost of making it hard to add simple things and by reducing DRYness. As a result, the targetNamePrefix and targetAccess properties were added as shorthands to targetOverrides modifications. This is not a scalable approach to the config format.
Describe the solution you'd like
Switch to a variable-based approach, where Mantle provides a simple variable expansion to the user's config. Mantle will provide a set of default variables (like environmentLabel) and will allow the user to define their own variables per environment via a variables dictionary property on the environment object.
environments:
- label: dev
variables:
environmentPostfix: ' - Development'
playability: public
- label: prod
variables:
environmentPostfix: ''
playability:
target:
experience:
configuration:
playability: $playability
places:
start:
configuration:
name: My Game$environmentPostfix
In order for this to work we would need to perform the variable expansion before parsing the config with serde. To do this we could do an initial parse of just the environments property (without any expansion), expand variables on the whole file's contents, then parse with serde.
To make this more useful and powerful we could also allow some simple expressions:
target:
experience:
places:
start:
configuration:
name: My Game${ if(ne($environmentLabel, 'prod'), concat(' [', upper($environmentLabel), ']')) }
name: My Game${ if $environmentLabel != 'prod' then ' [$environmentLabel]' }
Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.11.4...v0.11.5
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.11.3...v0.11.4
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.11.2...v0.11.3
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.11.1...v0.11.2
Source code(tar.gz)This version adds two main features:
mantle state commands for downloading and uploading state files and the option to change the key used for local state filesPRs:
Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.11.0...v0.11.1
Source code(tar.gz)⚠️ Breaking changes ⚠️
Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.10.8...v0.11.0
environments.*.name to environments.*.labelenvironments.*.overrides to environments.*.targetOverridestarget.experience.configuration.icon to target.experience.icontarget.experience.configuration.thumbnails to target.experience.thumbnailstarget.experience.configuration.paidAccessPrice with new format:# disabled
target:
experience:
configuration:
paidAccess: disabled
# enabled with price
target:
experience:
configuration:
paidAccess:
price: 50
target.experience.configuration.privateServerPrice with new format:# disabled
target:
experience:
configuration:
privateServers: disabled
# enabled with price
target:
experience:
configuration:
privateServers:
price: 50
# free
target:
experience:
configuration:
privateServers: free
Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.10.7...v0.10.8
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.10.6...v0.10.7
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.10.5...v0.10.6
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.10.4...v0.10.5
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.10.3...v0.10.4
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.10.2...v0.10.3
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.10.1...v0.10.2
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.10.0...v0.10.1
Source code(tar.gz)⚠ Many breaking changes. This release should hopefully stabilize most APIs going forward
Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.9.0...v0.10.0
Source code(tar.gz)⚠Project renamed from "rocat" to "mantle"
Full Changelog: https://github.com/blake-mealey/mantle/compare/v0.8.2...v0.9.0
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/rocat/compare/v0.8.1...v0.8.2
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/rocat/compare/v0.8.0...v0.8.1
Source code(tar.gz)⚠ Breaking change: move templates.experience.developerProducts to templates.products and rename resource types in state files: experienceDeveloperProduct -> developerProduct and experienceDeveloperProductIcon -> developerProductIcon
Full Changelog: https://github.com/blake-mealey/rocat/compare/v0.7.0...v0.8.0
Source code(tar.gz)This release adds a few breaking changes:
ROBLOX_API_KEY is no longer used for any operations. You must use ROBLOSECURITY now.deployMode is no longer supported. All place deploys will now be in "publish" mode.Full Changelog: https://github.com/blake-mealey/rocat/compare/v0.6.1...v0.7.0
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/rocat/compare/v0.6.0...v0.6.1
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/rocat/compare/v0.5.1...v0.6.0
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/rocat/compare/v0.5.0...v0.5.1
Source code(tar.gz)⚠ This release breaks multi-deployment configurations (the state file format does not support multiple deployments). Fixed in the next version. ⚠ This release breaks git tagging. Fixed in v0.6.1.
Full Changelog: https://github.com/blake-mealey/rocat/compare/v0.4.0...v0.5.0
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/rocat/compare/v0.3.0...v0.4.0
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/rocat/compare/v0.2.0...v0.3.0
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/rocat/compare/v0.1.5...v0.2.0
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/rocat/compare/v0.1.4...v0.1.5
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/rocat/compare/v0.1.3...v0.1.4
Source code(tar.gz)Full Changelog: https://github.com/blake-mealey/rocat/compare/v0.1.2...v0.1.3
Source code(tar.gz)Habitat is open source software that creates platform-independent build artifacts and provides built-in deployment and management capabilities. The go
Qovery Engine is an open-source abstraction layer library that turns easy apps deployment on AWS, GCP, Azure, and other Cloud providers in just a few minutes.
Normal people don't reinstall their OS from scratch very often. When they do, the moment they reach that pristine desktop or terminal after a clean in
rsw-node wasm-pack build executed in remote deployment, use with vite-plugin-rsw. Pre-installed rust nodejs wasm-pack: npm install -g wasm-pack vite-p
Docker Activity Docker activity is a tool to monitor the statistics of your containers and output their energy consumption. Warning It's still in earl
runc Introduction runc is a CLI tool for spawning and running containers on Linux according to the OCI specification. Releases You can find official r
Shallow Container is a light-weight container tool written in Rust. It is totally for proof-of-concept and may not suit for production environment.
Angea Naming from hydrangea(アジサイ) A lite tool to make systemd work in any container(Windows Subsystem for Linux 2, Docker, Podman, etc.) WSL1 is not s
Insject insject is a tool for poking at containers. It enables you to run an arbitrary command in a container or any mix of Linux namespaces. It suppo
rust-musl-builder: Docker container for easily building static Rust binaries Source on GitHub Changelog UPDATED: Major updates in this release which m
Heroku buildpack for Rust This is a Heroku buildpack for Rust with support for cargo and rustup. Features include: Caching of builds between deploymen
Valheim Docker If you are looking for a guide on how to get started click here Mod Support! It is supported to launch the server with BepInEx but!!!!!
oci-lib Oci-Spec for your container runtime or container registry. Oci-lib is a rust port for original oci spec written in go. Following crate contain
Holochain Launcher A cross-platform executable that launches a local Holochain conductor, and installs and opens apps. Feedback is immensely welcome i
kube-rs Rust client for Kubernetes in the style of a more generic client-go, a runtime abstraction inspired by controller-runtime, and a derive macro
Toast ?? Toast is a tool for doing work in containers. You define tasks in a YAML file called a toastfile, and Toast runs them in a containerized envi
reinlinsen ?? rl is a tool to inspect and dump OCI images or single image layers. Installation From source If you have cargo installed you can just ru
Mantle ?? An infrastructure-as-code and deployment tool for Roblox. ⚠ Please note that this is an early release and the API is unstable. Releases foll
Rust S̵̓i̸̓n̵̉ I̴n̴f̶e̸r̵n̷a̴l mutability! Howdy, friendly Rust developer! Ever had a value get m̵̯̅ð̶͊v̴̮̾ê̴̼͘d away right under your nose just when
Warp is a blazingly fast, Rust-based terminal that makes you and your team more productive at running, debugging, and deploying code and infrastructure.
2.4k Dec 27, 2022
1.9k Jan 4, 2023
83 Dec 27, 2022
10 Jul 6, 2022
39 Dec 6, 2022
9.9k Jan 5, 2023
14 Apr 8, 2022
16 Dec 5, 2022
44 Nov 9, 2022
1.3k Jan 1, 2023
657 Dec 30, 2022
12 Mar 10, 2022
58 Dec 30, 2022
1.8k Jan 8, 2023
1.4k Dec 27, 2022
5 May 11, 2023
44 Dec 22, 2022
294 Dec 23, 2022
10.4k Jan 4, 2023