diff --git a/.tx/config b/.tx/config index 7393a474..04a12c07 100644 --- a/.tx/config +++ b/.tx/config @@ -231,3 +231,17 @@ minimum_perc = 0 source_file = en/markdown/addons/middle-click-popup.md source_lang = en type = GITHUBMARKDOWN + +[o:scratch-addons:p:scratch-addons-website:r:markdown_addons_60fps] +file_filter = /markdown/addons/60fps.md +minimum_perc = 0 +source_file = en/markdown/addons/60fps.md +source_lang = en +type = GITHUBMARKDOWN + +[o:scratch-addons:p:scratch-addons-website:r:markdown_addons_paint-by-default] +file_filter = /markdown/addons/paint-by-default.md +minimum_perc = 0 +source_file = en/markdown/addons/paint-by-default.md +source_lang = en +type = GITHUBMARKDOWN diff --git a/en/markdown/addons/60fps.md b/en/markdown/addons/60fps.md new file mode 100644 index 00000000..76575d9e --- /dev/null +++ b/en/markdown/addons/60fps.md @@ -0,0 +1,62 @@ +--- +{} +--- + +**Higher project framerate mode** is an addon that allows customization of the project's run speed to be faster than the default of 30 FPS. This has the effect of making the project appear to run smoother and at a faster rate relative to the custom FPS value; therefore, the default value of 60 FPS will essentially make the project run twice as fast. + +The feature can be quickly toggled on/off by holding `alt` and clicking the green flag. The flag will turn blue and a yellow fast-forward icon will appear over it, indicating that the project is running at a faster speed. + +## Features + +- The addon's functionality is only enabled whenever the user toggles it on by holding `alt` and clicking the green flag. The addon's functionality is toggled off every time the page is opened/refreshed. +- The addon works in both the project page and the editor. +- By default, the addon (when toggled on) sets the project's framerate to 60 FPS. This value can be changed in the addon's settings to an integer ranging from 31 to 240. + +## Settings + +### Custom FPS + +Sets the value of the project's framerate when the addon is enabled. + +## Future plans + +- The addon might be marked as dangerous to curb projects that require this addon on the Scratch website. [#6860](https://github.com/ScratchAddons/ScratchAddons/issues/6860) +- Because enabling the addon requires holding the `alt` key, it is not compatable with touchscreen devices. A proposed solution is to add a context menu to the green flag for this addon and several others. [#7230](https://github.com/ScratchAddons/ScratchAddons/issues/7230) + +## Credit + +Jeffalo created the original addon that only set the project player to 60 FPS. TheColaber added the custom FPS setting and various other bug fixes. The accessible green flag indicator was created by JoanRiosiPla before being tweaked by WorldLanguages. + +## Changelog + +- **v1.1.0** The **60FPS Player Mode** addon was created. +- **v1.3.0** The addon is now enabled by default for all users, and was given the Recommended tag. +- **v1.7.0** Option added to customize the target FPS, which was locked to 60 before. +- **v1.11.0** The addon was renamed to **Alt+GreenFlag 60FPS player mode**, and a brief information box was added. A limit was set on the custom FPS, which now ranges from 31 to 240. +- **v1.13.0** `Alt` + green flag click detection was improved. The addon can now be dynamically enabled and disabled. +- **v1.14.0** The addon was given the Project Player tag. +- **v1.18.0** The addon was renamed to **60FPS project player mode**. The addon can now run in project embeds. +- **v1.24.0** Bug fix: The addon no longer loses track of state when changing from project page to editor. +- **v1.26.0** Bug fix: The addon no longer causes variables to not visually update in some cases. +- **v1.30.0** The addon is no longer enabled by default for all users. +- **v1.34.0** A more accessible yellow fast-forward icon was added to the green flag indicator whenever the addon is toggled on. Information box was rewritten to clarify that most projects will not behave properly when addon is enabled. +- **v1.36.0** The addon was renamed to **Higher project framerate mode**. The addon's description and information box was rewritten for clarity. +- **v1.37.0** A second information box was added that explains issues with user devices' power saving mode. + +## Trivia + +- Although TurboWarp Addons does not have this addon, Turbowarp's advanced project settings allows you to customize the project's framerate in a similar way. +- Despite the addon's setting for customizing the FPS is limited from 31 to 240, the Scratch project player is perfectly fine with values both lower and higher than these limits! There are several ways to bypass this limit, as only the setting's input field sets the limit. +- Jeffalo added the addon because "its hecking cool"[^1] +- There is a method that allows Scratch projects to roughly detect a custom FPS, which may indicate that the addon is enabled.[^2] + +## Gallery + +{{< docs/stub-section >}} + +## Related + +{{< docs/stub-section >}} + +[^1]: https://github.com/ScratchAddons/ScratchAddons/pull/383#issue-714126835 +[^2]: https://en.scratch-wiki.info/wiki/Making_an_FPS_Counter \ No newline at end of file diff --git a/en/markdown/addons/paint-by-default.md b/en/markdown/addons/paint-by-default.md new file mode 100644 index 00000000..5549e36b --- /dev/null +++ b/en/markdown/addons/paint-by-default.md @@ -0,0 +1,63 @@ +--- +{} +--- + +**Paint costume by default** is an addon that changes the functionality of buttons that add a new sprite, costume, backdrop, and sound. In vanila Scratch, pressing the main button will open Scratch's asset library. This addon allows the default action to be customized in the addon settings, allowing a choice between: library (Scratch's default), paint or record, surprise, or upload. + +## Background + +The addon was created under the philosophy that intermediate and advanced Scratchers rarely use assets from the Scratch library. It is common for these users to make a new sprite/costume/backdrop by hovering over the main button then navigating to the Paint option. As this is a timely maneuver, the addon's default settings change the default action of the main button to open the paint editor rather than opening the asset library. + +## Features + +- The addon allows users to customize the default action for each of the following buttons: "Choose a Sprite", "Choose a Costume", "Choose a Backdrop", and "Choose a Sound". +- Each of the buttons above have the following four options, which are pulled from the vanilla button's list when hovered: + - Library: Opens the corresponding Scratch asset library, depending on which button was pressed(Scratch's default) + - Paint/Record: Immediately opens the costume editor, or opens the audio recorder for the "Choose a Sound" button + - Surprise: Randomly selects from the corresponding Scratch asset library + - Upload: Allows you to upload a file +- The tooltip that appears when hovering over the main button also displays the correct default action. + +## Settings + +### Add Sprite + +- Changes the default action of the "Choose a Sprite" button, which is located at the bottom right of the sprite pane. + +### Add Costume + +- Changes the default action of the "Choose a Costume" button, which is located at the bottom of the costume list in the costume editor for any sprite. + +### Add Backdrop + +- Changes the default action of the "Choose a Backdrop" button, which is located at the bottom of the Backdrop pane and the bottom of the backdrop list in the stage's costume editor. + +### Add Sprite + +- Changes the default action of the "Choose a Sound" button, which is located at the bottom of the sound list in the sound editor for any sprite or the backdrop. + +## Known issues + +- You cannot set the default action to any custom actions added by a Scratch modification. This includes the "HD Upload" option added by the _HD image uploads_ addon. +- The addon's name "Paint costume by default" does not represent its options to change the default actions for the sprite, backdrop, or sound buttons. This issue is not planned to be resolved. [#6076](https://github.com/ScratchAddons/ScratchAddons/issues/6076) + +## Credit + +GarboMuffin developed the entirety of the addon. Its final name, description, settings, and tags were made by WorldLanguages. + +## Changelog + +- **v1.19.0** The **Paint costume by default** addon was created. +- **v1.19.1** Bug fix: Addon no longer treats the "Choose a Sound" button like a "Choose a Costume" button if the current sprite had no sounds. + +## Trivia + +{{< docs/stub-section >}} + +## Gallery + +{{< docs/stub-section >}} + +## Related + +- [Original pull request (#3199)](https://github.com/ScratchAddons/ScratchAddons/pull/3199) diff --git a/en/static-front.yml b/en/static-front.yml index b7773a6b..243048e3 100644 --- a/en/static-front.yml +++ b/en/static-front.yml @@ -1,7 +1,11 @@ +addons/60fps.md: + id: 60fps addons/_index.html: layout: home addons/middle-click-popup.md: id: middle-click-popup +addons/paint-by-default.md: + id: paint-by-default credits.html: aliases: - /contributors