Vegz78 / pxt-skillmap-DD

A sample repo for making a MakeCode skillmap

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

MakeCode D&D Skill Map

This is a great skill map that contains a D&D text adventure game learning path. You can view the content here:
https://arcade.makecode.com/--skillmap#github:Vegz78/pxt-skillmap-DD/skillmap

One-pager:
https://forum.makecode.com/t/coming-soon-text-based-adventure-tutorial-for-dungeons-dragons-honor-among-thieves/17403/21

Github-hosted skill maps are loaded in the same manner as tutorials, with a URL fragment formatted as follows:

#github:[organization name]/[repository name]/[markdown file name]

Miscellaneous

Some MS tutorial extension with different asset packs: https://github.com/microsoft/arcade-tutorial-extensions
E.g.:
github:microsoft/arcade-tutorial-extensions/adventure#v0.0.12
github:microsoft/arcade-tutorial-extensions/dnd-sprite-pack#v0.0.10
etc.
(Add the above as extensions...)

Pixel Art RPG Character Creator by edermunizz:
https://forum.makecode.com/t/something-cool-i-found/19411

Open older versions of skillmaps like this(does not work if underlying links have been updated):
https://arcade.makecode.com/--skillmap#https://raw.githubusercontent.com/microsoft/pxt-arcade/v1.13.18/docs/skillmap/adventure.md

Open GitHub repository skillmap directly without releases:
https://arcade.makecode.com/--skillmap#https://raw.githubusercontent.com/Vegz78/pxt-skillmap-DD/main/skillmap.md

Making skillmaps

https://makecode.com/writing-docs/skillmaps
https://forum.makecode.com/t/how-do-you-make-a-skill-map-for-tutorials/12912

Syntax

The skill map definition can be found in the skillmap.md file. Metadata about the skill map itself can be found under the top-level heading:

  • id: The string after the heading (eg # sample). Cannot contain spaces.
  • name: The title of your skill map. This will be displayed in the banner on the page.
  • description: A description of the map contents. This is also shown in the banner.
  • infoUrl (optional): A URL to a page with additional educator information

Learning Paths

A skill map consists of one or more "paths", each path being an ordered sequence of activities. The first activity in each path is unlocked, and completing an activity unlocks the next one.

A learning path is defined by a level two heading (##) has has the following properties:

  • id: The string after the heading (eg ## interface). Must be unique within this skill map.
  • name: The title of the path, displayed above the linked activities.
  • description: Additional details (not currently displayed).
  • completionUrl: URL to a certificate, displayed when a user has completed the entire path.

Activities

Each learning path has multiple activities, defined by level three headings (###). Currently, an "activity" is simply a MakeCode tutorial, and has the following properties:

  • id: The string after the heading (eg ### space-activity1). Must be unique within this skill map.
  • name: The title of the activity. Displayed on the activity card.
  • type: The type of activity. Must be tutorial currently.
  • description: Details about the activity, displayed on the back of the card.
  • tags: Descriptive tags displayed on the bottom of the activity card.
  • url: Link to the tutorial. See the MakeCode Tutorial Documentation for details on tutorial authoring and link formatting.
  • imageUrl: URL for the image displayed on the front of the activity card.

Forking

If you fork this repo, be sure to change all URL references to https://github.com/microsoft/pxt-skillmap-sample to your forked repo's URL. Otherwise you won't see your changes.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.

About

A sample repo for making a MakeCode skillmap

License:MIT License