Skip to content

Creating a Location

Jump to bottom
George112n edited this page Jul 2, 2024 · 1 revision

Introduction

In order for a 'tutorial' to be playable, it needs to have a least one location. A location is to a tutorial as a 'map' is to a minigames game.

A tutorial can have an unlimited number of locations created for it, they are created by the creator of the tutorial in the process outlined below. The purpose of locations is to allow players to practice the same tutorial multiple times without learning the answers.

The process for completing a given tutorial is the same for any location of that tutorial, but the answers for any of the tasks may differ. For example if it's in a different location, the tpll answers will likely be different.

A tutorial itself doesn't have any answers associated with it, the creator sets the answers to a location.

Creating a location/setting the answers.

  1. If you have a multi-server setup, connect to the tutorials server. (Use /server tutorials on the BTE UK server).
  2. Open the tutorials menu using the green emerald, or type /tutorials
  3. Click on the admin menu option in the bottom left hand corner
  4. Click the bookshelf option for 'My Tutorials'. In the My Tutorials menu you will have the option to set tutorials in use or create new locations for them.

From this point, please complete the entire location creation process in one go. If you do not have enough time to fully complete it then don't proceed

  1. Right click on the tutorial that you want to create a location for.
  2. Find your tutorial's new location on Google Maps
  3. Use tpll to define the region that needs to be generated. When you tpll you will tpll into the void. Your tpll points will be used as your points, you only have to tpll, you do not need to select anything. Go round in a circle, marking out the bounds of the area. This does not have to be precise because the terrain will be generated in chunks.
  4. Once you have finished drawing the area, run /tutorials endarea and then tpll one more time to the desired start location of the location.

The area will now be generated in a new world and you will be transported shortly.

At this point your job is to run though the tutorial, and the blocks you select, commands you run, messages you send etc. will determine the answers. For each task, when you enter the answer you will be able to change it up until you run /tutorials [difficulty] which specifies the difficulty of the task you just completed.

Do not worry too much about the difficulty, but it must be an integer or floating point number between 0 and 1. This is [0,1] in set notation, so 0 and 1 are allowed values.

For each step you will have to specify the start location (including player direction) of the step, the location of the hologram if that is what you selected, and you will have to write the instructions. You do this in the location creation menu. Open the menu.

  • To specify the start location, position yourself in the position and direction of the intended start location and then open the menu and select the option to set the start location to your location.
  • The same system is used to specify the location of the hologram, just click the 'position hologram' option this time.
  • Click the book to start editing the step instructions. If a change was detected then this will be saved and the hologram will be updated.

If you want coloured text then use the '&' Minecraft letter colour codes before each word. For example &ATpll &Ato &Aeach &Acorner would produce green text.

If you make a small mistake then we can manually change it in the database once the location has been created, so do not worry.

  1. Repeat the above steps for every tutorial Step until you have completed the tutorial!

Clone this wiki locally

, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all 
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Creating a Location · BuildtheUK/TeachingTutorials Wiki · GitHub
Skip to content
Creating a Location
Jump to bottom

George112n edited this page Jul 2, 2024
·
1 revision
Introduction
In order for a 'tutorial' to be playable, it needs to have a least one location. A location is to a tutorial as a 'map' is to a minigames game.
A tutorial can have an unlimited number of locations created for it, they are created by the creator of the tutorial in the process outlined below. The purpose of locations is to allow players to practice the same tutorial multiple times without learning the answers.
The process for completing a given tutorial is the same for any location of that tutorial, but the answers for any of the tasks may differ. For example if it's in a different location, the tpll answers will likely be different.
A tutorial itself doesn't have any answers associated with it, the creator sets the answers to a location.
Creating a location/setting the answers.
  1. If you have a multi-server setup, connect to the tutorials server. (Use /server tutorials on the BTE UK server).
  2. Open the tutorials menu using the green emerald, or type /tutorials
  3. Click on the admin menu option in the bottom left hand corner
  4. Click the bookshelf option for 'My Tutorials'. In the My Tutorials menu you will have the option to set tutorials in use or create new locations for them.
From this point, please complete the entire location creation process in one go. If you do not have enough time to fully complete it then don't proceed
  1. Right click on the tutorial that you want to create a location for.
  2. Find your tutorial's new location on Google Maps
  3. Use tpll to define the region that needs to be generated. When you tpll you will tpll into the void. Your tpll points will be used as your points, you only have to tpll, you do not need to select anything. Go round in a circle, marking out the bounds of the area. This does not have to be precise because the terrain will be generated in chunks.
  4. Once you have finished drawing the area, run /tutorials endarea and then tpll one more time to the desired start location of the location.
The area will now be generated in a new world and you will be transported shortly.
At this point your job is to run though the tutorial, and the blocks you select, commands you run, messages you send etc. will determine the answers. For each task, when you enter the answer you will be able to change it up until you run /tutorials [difficulty] which specifies the difficulty of the task you just completed.
Do not worry too much about the difficulty, but it must be an integer or floating point number between 0 and 1. This is [0,1] in set notation, so 0 and 1 are allowed values.
For each step you will have to specify the start location (including player direction) of the step, the location of the hologram if that is what you selected, and you will have to write the instructions. You do this in the location creation menu. Open the menu.
  • To specify the start location, position yourself in the position and direction of the intended start location and then open the menu and select the option to set the start location to your location.
  • The same system is used to specify the location of the hologram, just click the 'position hologram' option this time.
  • Click the book to start editing the step instructions. If a change was detected then this will be saved and the hologram will be updated.
If you want coloured text then use the '&' Minecraft letter colour codes before each word. For example &ATpll &Ato &Aeach &Acorner would produce green text.
If you make a small mistake then we can manually change it in the database once the location has been created, so do not worry.
  1. Repeat the above steps for every tutorial Step until you have completed the tutorial!
Clone this wiki locally

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Force GitHub README to respect dark mode
(function() {
var style = document.createElement('style');
style.textContent = '
.markdown-body {
color-scheme: dark light;
}
.markdown-body pre { background: #161b22 !important; }
.markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }
.markdown-body table th, .markdown-body table td { border-color: #30363d !important; }
.markdown-body img { background: #0d1117; }
.markdown-body blockquote { border-left-color: #8b949e; }
.markdown-body hr { border-color: #30363d; }
';
document.head.appendChild(style);
})();
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
Creating a Location · BuildtheUK/TeachingTutorials Wiki · GitHub
Skip to content
Creating a Location
Jump to bottom

George112n edited this page Jul 2, 2024
·
1 revision
Introduction
In order for a 'tutorial' to be playable, it needs to have a least one location. A location is to a tutorial as a 'map' is to a minigames game.
A tutorial can have an unlimited number of locations created for it, they are created by the creator of the tutorial in the process outlined below. The purpose of locations is to allow players to practice the same tutorial multiple times without learning the answers.
The process for completing a given tutorial is the same for any location of that tutorial, but the answers for any of the tasks may differ. For example if it's in a different location, the tpll answers will likely be different.
A tutorial itself doesn't have any answers associated with it, the creator sets the answers to a location.
Creating a location/setting the answers.
  1. If you have a multi-server setup, connect to the tutorials server. (Use /server tutorials on the BTE UK server).
  2. Open the tutorials menu using the green emerald, or type /tutorials
  3. Click on the admin menu option in the bottom left hand corner
  4. Click the bookshelf option for 'My Tutorials'. In the My Tutorials menu you will have the option to set tutorials in use or create new locations for them.
From this point, please complete the entire location creation process in one go. If you do not have enough time to fully complete it then don't proceed
  1. Right click on the tutorial that you want to create a location for.
  2. Find your tutorial's new location on Google Maps
  3. Use tpll to define the region that needs to be generated. When you tpll you will tpll into the void. Your tpll points will be used as your points, you only have to tpll, you do not need to select anything. Go round in a circle, marking out the bounds of the area. This does not have to be precise because the terrain will be generated in chunks.
  4. Once you have finished drawing the area, run /tutorials endarea and then tpll one more time to the desired start location of the location.
The area will now be generated in a new world and you will be transported shortly.
At this point your job is to run though the tutorial, and the blocks you select, commands you run, messages you send etc. will determine the answers. For each task, when you enter the answer you will be able to change it up until you run /tutorials [difficulty] which specifies the difficulty of the task you just completed.
Do not worry too much about the difficulty, but it must be an integer or floating point number between 0 and 1. This is [0,1] in set notation, so 0 and 1 are allowed values.
For each step you will have to specify the start location (including player direction) of the step, the location of the hologram if that is what you selected, and you will have to write the instructions. You do this in the location creation menu. Open the menu.
  • To specify the start location, position yourself in the position and direction of the intended start location and then open the menu and select the option to set the start location to your location.
  • The same system is used to specify the location of the hologram, just click the 'position hologram' option this time.
  • Click the book to start editing the step instructions. If a change was detected then this will be saved and the hologram will be updated.
If you want coloured text then use the '&' Minecraft letter colour codes before each word. For example &ATpll &Ato &Aeach &Acorner would produce green text.
If you make a small mistake then we can manually change it in the database once the location has been created, so do not worry.
  1. Repeat the above steps for every tutorial Step until you have completed the tutorial!
Clone this wiki locally

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Highlight search terms from Google/DuckDuckGo/Bing referrer
(function() {
var ref = document.referrer;
var terms = [];
if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {
var url = new URL(ref);
var q = url.searchParams.get('q') || url.searchParams.get('p');
if (q) {
terms = q.split(/\s+/).filter(function(t) { return t.length > 2; });
}
}
if (terms.length === 0) return;
var style = document.createElement('style');
style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';
document.head.appendChild(style);
function highlight(node) {
if (node.nodeType === 3) { // text node
var text = node.textContent;
var found = false;
terms.forEach(function(term) {
var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi');
if (regex.test(text)) {
found = true;
var frag = document.createDocumentFragment();
var parts = text.split(regex);
parts.forEach(function(part, i) {
if (i % 2 === 0) {
frag.appendChild(document.createTextNode(part));
} else {
var span = document.createElement('span');
span.className = 'userscript-highlight';
span.textContent = part;
frag.appendChild(span);
}
});
node.parentNode.replaceChild(frag, node);
}
});
} else if (node.nodeType === 1 && node.childNodes) { // element
var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];
if (!skipTags.includes(node.tagName)) {
Array.from(node.childNodes).forEach(highlight);
}
}
}
highlight(document.body);
// Re-highlight on dynamic content
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1 || node.nodeType === 3) highlight(node);
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
Creating a Location · BuildtheUK/TeachingTutorials Wiki · GitHub
Skip to content
Creating a Location
Jump to bottom

George112n edited this page Jul 2, 2024
·
1 revision
Introduction
In order for a 'tutorial' to be playable, it needs to have a least one location. A location is to a tutorial as a 'map' is to a minigames game.
A tutorial can have an unlimited number of locations created for it, they are created by the creator of the tutorial in the process outlined below. The purpose of locations is to allow players to practice the same tutorial multiple times without learning the answers.
The process for completing a given tutorial is the same for any location of that tutorial, but the answers for any of the tasks may differ. For example if it's in a different location, the tpll answers will likely be different.
A tutorial itself doesn't have any answers associated with it, the creator sets the answers to a location.
Creating a location/setting the answers.
  1. If you have a multi-server setup, connect to the tutorials server. (Use /server tutorials on the BTE UK server).
  2. Open the tutorials menu using the green emerald, or type /tutorials
  3. Click on the admin menu option in the bottom left hand corner
  4. Click the bookshelf option for 'My Tutorials'. In the My Tutorials menu you will have the option to set tutorials in use or create new locations for them.
From this point, please complete the entire location creation process in one go. If you do not have enough time to fully complete it then don't proceed
  1. Right click on the tutorial that you want to create a location for.
  2. Find your tutorial's new location on Google Maps
  3. Use tpll to define the region that needs to be generated. When you tpll you will tpll into the void. Your tpll points will be used as your points, you only have to tpll, you do not need to select anything. Go round in a circle, marking out the bounds of the area. This does not have to be precise because the terrain will be generated in chunks.
  4. Once you have finished drawing the area, run /tutorials endarea and then tpll one more time to the desired start location of the location.
The area will now be generated in a new world and you will be transported shortly.
At this point your job is to run though the tutorial, and the blocks you select, commands you run, messages you send etc. will determine the answers. For each task, when you enter the answer you will be able to change it up until you run /tutorials [difficulty] which specifies the difficulty of the task you just completed.
Do not worry too much about the difficulty, but it must be an integer or floating point number between 0 and 1. This is [0,1] in set notation, so 0 and 1 are allowed values.
For each step you will have to specify the start location (including player direction) of the step, the location of the hologram if that is what you selected, and you will have to write the instructions. You do this in the location creation menu. Open the menu.
  • To specify the start location, position yourself in the position and direction of the intended start location and then open the menu and select the option to set the start location to your location.
  • The same system is used to specify the location of the hologram, just click the 'position hologram' option this time.
  • Click the book to start editing the step instructions. If a change was detected then this will be saved and the hologram will be updated.
If you want coloured text then use the '&' Minecraft letter colour codes before each word. For example &ATpll &Ato &Aeach &Acorner would produce green text.
If you make a small mistake then we can manually change it in the database once the location has been created, so do not worry.
  1. Repeat the above steps for every tutorial Step until you have completed the tutorial!
Clone this wiki locally

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Strip utm_, fbclid, gclid, etc. from all links on page
(function() {
var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',
'ref', 'ref_src', 'source', 'medium', 'campaign'];
function cleanUrl(url) {
try {
var u = new URL(url, window.location.origin);
var changed = false;
trackingParams.forEach(function(p) {
if (u.searchParams.has(p)) {
u.searchParams.delete(p);
changed = true;
}
});
return changed ? u.toString() : url;
} catch (e) {
return url;
}
}
function cleanLinks() {
document.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
cleanLinks();
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1) {
if (node.tagName === 'A') cleanLinks();
node.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '
Creating a Location · BuildtheUK/TeachingTutorials Wiki · GitHub
Skip to content
Creating a Location
Jump to bottom

George112n edited this page Jul 2, 2024
·
1 revision
Introduction
In order for a 'tutorial' to be playable, it needs to have a least one location. A location is to a tutorial as a 'map' is to a minigames game.
A tutorial can have an unlimited number of locations created for it, they are created by the creator of the tutorial in the process outlined below. The purpose of locations is to allow players to practice the same tutorial multiple times without learning the answers.
The process for completing a given tutorial is the same for any location of that tutorial, but the answers for any of the tasks may differ. For example if it's in a different location, the tpll answers will likely be different.
A tutorial itself doesn't have any answers associated with it, the creator sets the answers to a location.
Creating a location/setting the answers.
  1. If you have a multi-server setup, connect to the tutorials server. (Use /server tutorials on the BTE UK server).
  2. Open the tutorials menu using the green emerald, or type /tutorials
  3. Click on the admin menu option in the bottom left hand corner
  4. Click the bookshelf option for 'My Tutorials'. In the My Tutorials menu you will have the option to set tutorials in use or create new locations for them.
From this point, please complete the entire location creation process in one go. If you do not have enough time to fully complete it then don't proceed
  1. Right click on the tutorial that you want to create a location for.
  2. Find your tutorial's new location on Google Maps
  3. Use tpll to define the region that needs to be generated. When you tpll you will tpll into the void. Your tpll points will be used as your points, you only have to tpll, you do not need to select anything. Go round in a circle, marking out the bounds of the area. This does not have to be precise because the terrain will be generated in chunks.
  4. Once you have finished drawing the area, run /tutorials endarea and then tpll one more time to the desired start location of the location.
The area will now be generated in a new world and you will be transported shortly.
At this point your job is to run though the tutorial, and the blocks you select, commands you run, messages you send etc. will determine the answers. For each task, when you enter the answer you will be able to change it up until you run /tutorials [difficulty] which specifies the difficulty of the task you just completed.
Do not worry too much about the difficulty, but it must be an integer or floating point number between 0 and 1. This is [0,1] in set notation, so 0 and 1 are allowed values.
For each step you will have to specify the start location (including player direction) of the step, the location of the hologram if that is what you selected, and you will have to write the instructions. You do this in the location creation menu. Open the menu.
  • To specify the start location, position yourself in the position and direction of the intended start location and then open the menu and select the option to set the start location to your location.
  • The same system is used to specify the location of the hologram, just click the 'position hologram' option this time.
  • Click the book to start editing the step instructions. If a change was detected then this will be saved and the hologram will be updated.
If you want coloured text then use the '&' Minecraft letter colour codes before each word. For example &ATpll &Ato &Aeach &Acorner would produce green text.
If you make a small mistake then we can manually change it in the database once the location has been created, so do not worry.
  1. Repeat the above steps for every tutorial Step until you have completed the tutorial!
Clone this wiki locally

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Auto-enable theater mode on YouTube
(function() {
function tryTheater() {
var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]');
if (btn && !btn.classList.contains('activated')) {
btn.click();
}
}
// Try immediately
tryTheater();
// Try after navigation (SPA)
var lastUrl = location.href;
setInterval(function() {
if (location.href !== lastUrl) {
lastUrl = location.href;
setTimeout(tryTheater, 500);
}
}, 1000);
// Also try on player load
var observer = new MutationObserver(tryTheater);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
Creating a Location · BuildtheUK/TeachingTutorials Wiki · GitHub
Skip to content
Creating a Location
Jump to bottom

George112n edited this page Jul 2, 2024
·
1 revision
Introduction
In order for a 'tutorial' to be playable, it needs to have a least one location. A location is to a tutorial as a 'map' is to a minigames game.
A tutorial can have an unlimited number of locations created for it, they are created by the creator of the tutorial in the process outlined below. The purpose of locations is to allow players to practice the same tutorial multiple times without learning the answers.
The process for completing a given tutorial is the same for any location of that tutorial, but the answers for any of the tasks may differ. For example if it's in a different location, the tpll answers will likely be different.
A tutorial itself doesn't have any answers associated with it, the creator sets the answers to a location.
Creating a location/setting the answers.
  1. If you have a multi-server setup, connect to the tutorials server. (Use /server tutorials on the BTE UK server).
  2. Open the tutorials menu using the green emerald, or type /tutorials
  3. Click on the admin menu option in the bottom left hand corner
  4. Click the bookshelf option for 'My Tutorials'. In the My Tutorials menu you will have the option to set tutorials in use or create new locations for them.
From this point, please complete the entire location creation process in one go. If you do not have enough time to fully complete it then don't proceed
  1. Right click on the tutorial that you want to create a location for.
  2. Find your tutorial's new location on Google Maps
  3. Use tpll to define the region that needs to be generated. When you tpll you will tpll into the void. Your tpll points will be used as your points, you only have to tpll, you do not need to select anything. Go round in a circle, marking out the bounds of the area. This does not have to be precise because the terrain will be generated in chunks.
  4. Once you have finished drawing the area, run /tutorials endarea and then tpll one more time to the desired start location of the location.
The area will now be generated in a new world and you will be transported shortly.
At this point your job is to run though the tutorial, and the blocks you select, commands you run, messages you send etc. will determine the answers. For each task, when you enter the answer you will be able to change it up until you run /tutorials [difficulty] which specifies the difficulty of the task you just completed.
Do not worry too much about the difficulty, but it must be an integer or floating point number between 0 and 1. This is [0,1] in set notation, so 0 and 1 are allowed values.
For each step you will have to specify the start location (including player direction) of the step, the location of the hologram if that is what you selected, and you will have to write the instructions. You do this in the location creation menu. Open the menu.
  • To specify the start location, position yourself in the position and direction of the intended start location and then open the menu and select the option to set the start location to your location.
  • The same system is used to specify the location of the hologram, just click the 'position hologram' option this time.
  • Click the book to start editing the step instructions. If a change was detected then this will be saved and the hologram will be updated.
If you want coloured text then use the '&' Minecraft letter colour codes before each word. For example &ATpll &Ato &Aeach &Acorner would produce green text.
If you make a small mistake then we can manually change it in the database once the location has been created, so do not worry.
  1. Repeat the above steps for every tutorial Step until you have completed the tutorial!
Clone this wiki locally

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Remove or un-stick sticky/fixed headers that block content
(function() {
function unstick() {
document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) {
if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {
el.style.position = 'static';
el.style.top = 'auto';
el.style.zIndex = 'auto';
}
});
}
unstick();
var observer = new MutationObserver(unstick);
observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });
})();
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
Creating a Location · BuildtheUK/TeachingTutorials Wiki · GitHub
Skip to content
Creating a Location
Jump to bottom

George112n edited this page Jul 2, 2024
·
1 revision
Introduction
In order for a 'tutorial' to be playable, it needs to have a least one location. A location is to a tutorial as a 'map' is to a minigames game.
A tutorial can have an unlimited number of locations created for it, they are created by the creator of the tutorial in the process outlined below. The purpose of locations is to allow players to practice the same tutorial multiple times without learning the answers.
The process for completing a given tutorial is the same for any location of that tutorial, but the answers for any of the tasks may differ. For example if it's in a different location, the tpll answers will likely be different.
A tutorial itself doesn't have any answers associated with it, the creator sets the answers to a location.
Creating a location/setting the answers.
  1. If you have a multi-server setup, connect to the tutorials server. (Use /server tutorials on the BTE UK server).
  2. Open the tutorials menu using the green emerald, or type /tutorials
  3. Click on the admin menu option in the bottom left hand corner
  4. Click the bookshelf option for 'My Tutorials'. In the My Tutorials menu you will have the option to set tutorials in use or create new locations for them.
From this point, please complete the entire location creation process in one go. If you do not have enough time to fully complete it then don't proceed
  1. Right click on the tutorial that you want to create a location for.
  2. Find your tutorial's new location on Google Maps
  3. Use tpll to define the region that needs to be generated. When you tpll you will tpll into the void. Your tpll points will be used as your points, you only have to tpll, you do not need to select anything. Go round in a circle, marking out the bounds of the area. This does not have to be precise because the terrain will be generated in chunks.
  4. Once you have finished drawing the area, run /tutorials endarea and then tpll one more time to the desired start location of the location.
The area will now be generated in a new world and you will be transported shortly.
At this point your job is to run though the tutorial, and the blocks you select, commands you run, messages you send etc. will determine the answers. For each task, when you enter the answer you will be able to change it up until you run /tutorials [difficulty] which specifies the difficulty of the task you just completed.
Do not worry too much about the difficulty, but it must be an integer or floating point number between 0 and 1. This is [0,1] in set notation, so 0 and 1 are allowed values.
For each step you will have to specify the start location (including player direction) of the step, the location of the hologram if that is what you selected, and you will have to write the instructions. You do this in the location creation menu. Open the menu.
  • To specify the start location, position yourself in the position and direction of the intended start location and then open the menu and select the option to set the start location to your location.
  • The same system is used to specify the location of the hologram, just click the 'position hologram' option this time.
  • Click the book to start editing the step instructions. If a change was detected then this will be saved and the hologram will be updated.
If you want coloured text then use the '&' Minecraft letter colour codes before each word. For example &ATpll &Ato &Aeach &Acorner would produce green text.
If you make a small mistake then we can manually change it in the database once the location has been created, so do not worry.
  1. Repeat the above steps for every tutorial Step until you have completed the tutorial!
Clone this wiki locally

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Universal Dark Mode - works on any site
(function() {
var enabled = true;
function applyDarkMode() {
if (!enabled) return;
// Create style element if it doesn't exist
var style = document.getElementById('universal-dark-mode-style');
if (!style) {
style = document.createElement('style');
style.id = 'universal-dark-mode-style';
document.head.appendChild(style);
}
// Dark mode CSS - inverts colors but preserves images/video
style.textContent = '
/* Invert everything except media */
html {
filter: invert(1) hue-rotate(180deg) !important;
background: #1a1a2e !important;
}
/* Restore images, videos, iframes, canvas */
img, video, iframe, canvas, svg, picture, [style*="background-image"] {
filter: invert(1) hue-rotate(180deg) !important;
}
/* Preserve specific elements that should not be inverted */
.no-dark-mode, .no-dark-mode *,
[data-theme="light"], [data-theme="light"],
.ace_editor, .ace_editor *,
.CodeMirror, .CodeMirror *,
.monaco-editor, .monaco-editor *,
.markdown-body pre, .markdown-body pre *,
.highlight, .highlight *,
pre code, pre code * {
filter: none !important;
}
/* Fix common UI elements */
.modal, .popup, .dropdown-menu, .tooltip, .popover {
filter: invert(1) hue-rotate(180deg) !important;
background: #2d2d44 !important;
border-color: #444 !important;
}
/* Scrollbars */
::-webkit-scrollbar { background: #1a1a2e !important; }
::-webkit-scrollbar-thumb { background: #444 !important; }
::-webkit-scrollbar-thumb:hover { background: #555 !important; }
/* Selection */
::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
';
}
function removeDarkMode() {
var style = document.getElementById('universal-dark-mode-style');
if (style) style.remove();
}
// Toggle with Alt+Shift+D
document.addEventListener('keydown', function(e) {
if (e.altKey && e.shiftKey && e.key === 'D') {
e.preventDefault();
enabled = !enabled;
if (enabled) {
applyDarkMode();
console.log('[Universal Dark Mode] Enabled');
} else {
removeDarkMode();
console.log('[Universal Dark Mode] Disabled');
}
}
});
// Apply on load
applyDarkMode();
// Re-apply on dynamic content
var observer = new MutationObserver(function(mutations) {
if (enabled && !document.getElementById('universal-dark-mode-style')) {
applyDarkMode();
}
});
observer.observe(document.head, { childList: true });
console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');
})();
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();
Creating a Location · BuildtheUK/TeachingTutorials Wiki · GitHub
Skip to content
Creating a Location
Jump to bottom

George112n edited this page Jul 2, 2024
·
1 revision
Introduction
In order for a 'tutorial' to be playable, it needs to have a least one location. A location is to a tutorial as a 'map' is to a minigames game.
A tutorial can have an unlimited number of locations created for it, they are created by the creator of the tutorial in the process outlined below. The purpose of locations is to allow players to practice the same tutorial multiple times without learning the answers.
The process for completing a given tutorial is the same for any location of that tutorial, but the answers for any of the tasks may differ. For example if it's in a different location, the tpll answers will likely be different.
A tutorial itself doesn't have any answers associated with it, the creator sets the answers to a location.
Creating a location/setting the answers.
  1. If you have a multi-server setup, connect to the tutorials server. (Use /server tutorials on the BTE UK server).
  2. Open the tutorials menu using the green emerald, or type /tutorials
  3. Click on the admin menu option in the bottom left hand corner
  4. Click the bookshelf option for 'My Tutorials'. In the My Tutorials menu you will have the option to set tutorials in use or create new locations for them.
From this point, please complete the entire location creation process in one go. If you do not have enough time to fully complete it then don't proceed
  1. Right click on the tutorial that you want to create a location for.
  2. Find your tutorial's new location on Google Maps
  3. Use tpll to define the region that needs to be generated. When you tpll you will tpll into the void. Your tpll points will be used as your points, you only have to tpll, you do not need to select anything. Go round in a circle, marking out the bounds of the area. This does not have to be precise because the terrain will be generated in chunks.
  4. Once you have finished drawing the area, run /tutorials endarea and then tpll one more time to the desired start location of the location.
The area will now be generated in a new world and you will be transported shortly.
At this point your job is to run though the tutorial, and the blocks you select, commands you run, messages you send etc. will determine the answers. For each task, when you enter the answer you will be able to change it up until you run /tutorials [difficulty] which specifies the difficulty of the task you just completed.
Do not worry too much about the difficulty, but it must be an integer or floating point number between 0 and 1. This is [0,1] in set notation, so 0 and 1 are allowed values.
For each step you will have to specify the start location (including player direction) of the step, the location of the hologram if that is what you selected, and you will have to write the instructions. You do this in the location creation menu. Open the menu.
  • To specify the start location, position yourself in the position and direction of the intended start location and then open the menu and select the option to set the start location to your location.
  • The same system is used to specify the location of the hologram, just click the 'position hologram' option this time.
  • Click the book to start editing the step instructions. If a change was detected then this will be saved and the hologram will be updated.
If you want coloured text then use the '&' Minecraft letter colour codes before each word. For example &ATpll &Ato &Aeach &Acorner would produce green text.
If you make a small mistake then we can manually change it in the database once the location has been created, so do not worry.
  1. Repeat the above steps for every tutorial Step until you have completed the tutorial!
Clone this wiki locally