diff --git a/404.html b/404.html index 6c3a8ba1..ec233975 100644 --- a/404.html +++ b/404.html @@ -8,7 +8,7 @@ - + @@ -23,7 +23,7 @@
- + \ No newline at end of file diff --git a/assets/app.DfbtkHqc.js b/assets/app.BUnQVKtU.js similarity index 95% rename from assets/app.DfbtkHqc.js rename to assets/app.BUnQVKtU.js index 430f2971..b23c9563 100644 --- a/assets/app.DfbtkHqc.js +++ b/assets/app.BUnQVKtU.js @@ -1 +1 @@ -import{U as o,ar as p,as as u,at as l,au as c,av as f,aw as d,ax as m,ay as h,az as A,aA as g,d as v,u as y,y as P,x as w,aB as C,aC as R,aD as b,a8 as E}from"./chunks/framework.D8PMdl4T.js";import{R as S}from"./chunks/theme.DAkgjDNC.js";function i(e){if(e.extends){const a=i(e.extends);return{...a,...e,async enhanceApp(t){a.enhanceApp&&await a.enhanceApp(t),e.enhanceApp&&await e.enhanceApp(t)}}}return e}const s=i(S),T=v({name:"VitePressApp",setup(){const{site:e,lang:a,dir:t}=y();return P(()=>{w(()=>{document.documentElement.lang=a.value,document.documentElement.dir=t.value})}),e.value.router.prefetchLinks&&C(),R(),b(),s.setup&&s.setup(),()=>E(s.Layout)}});async function _(){globalThis.__VITEPRESS__=!0;const e=D(),a=x();a.provide(u,e);const t=l(e.route);return a.provide(c,t),a.component("Content",f),a.component("ClientOnly",d),Object.defineProperties(a.config.globalProperties,{$frontmatter:{get(){return t.frontmatter.value}},$params:{get(){return t.page.value.params}}}),s.enhanceApp&&await s.enhanceApp({app:a,router:e,siteData:m}),{app:a,router:e,data:t}}function x(){return h(T)}function D(){let e=o,a;return A(t=>{let n=g(t),r=null;return n&&(e&&(a=n),(e||a===n)&&(n=n.replace(/\.js$/,".lean.js")),r=import(n)),o&&(e=!1),r},s.NotFound)}o&&_().then(({app:e,router:a,data:t})=>{a.go().then(()=>{p(a.route,t.site),e.mount("#app")})});export{_ as createApp}; +import{U as o,ar as p,as as u,at as l,au as c,av as f,aw as d,ax as m,ay as h,az as A,aA as g,d as v,u as y,y as P,x as w,aB as C,aC as R,aD as b,a8 as E}from"./chunks/framework.D8PMdl4T.js";import{R as S}from"./chunks/theme.BjoghVOU.js";function i(e){if(e.extends){const a=i(e.extends);return{...a,...e,async enhanceApp(t){a.enhanceApp&&await a.enhanceApp(t),e.enhanceApp&&await e.enhanceApp(t)}}}return e}const s=i(S),T=v({name:"VitePressApp",setup(){const{site:e,lang:a,dir:t}=y();return P(()=>{w(()=>{document.documentElement.lang=a.value,document.documentElement.dir=t.value})}),e.value.router.prefetchLinks&&C(),R(),b(),s.setup&&s.setup(),()=>E(s.Layout)}});async function _(){globalThis.__VITEPRESS__=!0;const e=D(),a=x();a.provide(u,e);const t=l(e.route);return a.provide(c,t),a.component("Content",f),a.component("ClientOnly",d),Object.defineProperties(a.config.globalProperties,{$frontmatter:{get(){return t.frontmatter.value}},$params:{get(){return t.page.value.params}}}),s.enhanceApp&&await s.enhanceApp({app:a,router:e,siteData:m}),{app:a,router:e,data:t}}function x(){return h(T)}function D(){let e=o,a;return A(t=>{let n=g(t),r=null;return n&&(e&&(a=n),(e||a===n)&&(n=n.replace(/\.js$/,".lean.js")),r=import(n)),o&&(e=!1),r},s.NotFound)}o&&_().then(({app:e,router:a,data:t})=>{a.go().then(()=>{p(a.route,t.site),e.mount("#app")})});export{_ as createApp}; diff --git a/assets/chunks/theme.DAkgjDNC.js b/assets/chunks/theme.BjoghVOU.js similarity index 99% rename from assets/chunks/theme.DAkgjDNC.js rename to assets/chunks/theme.BjoghVOU.js index da7bb54a..610a4237 100644 --- a/assets/chunks/theme.DAkgjDNC.js +++ b/assets/chunks/theme.BjoghVOU.js @@ -1 +1 @@ -import{d as k,o as r,c as p,r as d,n as A,a as J,t as M,b as S,w as v,e as g,T as Ne,_ as L,u as We,i as mt,f as _t,g as me,h as V,j as h,k as l,p as z,l as j,m as ee,q as Le,s as I,v as X,x as _e,y as te,z as Me,A as Je,B as gt,C as kt,D as Z,F as C,E as F,G as Xe,H as ge,I as y,J as oe,K as Ye,L as ie,M as ue,N as ke,O as bt,P as Qe,Q as $t,R as Ae,S as Ze,U as be,V as yt,W as Pt,X as Vt,Y as ze,Z as Lt,$ as et,a0 as St,a1 as wt,a2 as tt,a3 as nt,a4 as It,a5 as Tt,a6 as Nt,a7 as Mt,a8 as je}from"./framework.D8PMdl4T.js";const At=k({__name:"VPBadge",props:{text:{},type:{default:"tip"}},setup(e){return(t,n)=>(r(),p("span",{class:A(["VPBadge",t.type])},[d(t.$slots,"default",{},()=>[J(M(t.text),1)])],2))}}),Ct={key:0,class:"VPBackdrop"},Ht=k({__name:"VPBackdrop",props:{show:{type:Boolean}},setup(e){return(t,n)=>(r(),S(Ne,{name:"fade"},{default:v(()=>[t.show?(r(),p("div",Ct)):g("",!0)]),_:1}))}}),Bt=L(Ht,[["__scopeId","data-v-c79a1216"]]),T=We;function Et(e,t){let n,s=!1;return()=>{n&&clearTimeout(n),s?n=setTimeout(e,t):(e(),(s=!0)&&setTimeout(()=>s=!1,t))}}function Se(e){return/^\//.test(e)?e:`/${e}`}function Ce(e){const{pathname:t,search:n,hash:s,protocol:o}=new URL(e,"http://a.com");if(mt(e)||e.startsWith("#")||!o.startsWith("http")||!_t(t))return e;const{site:a}=T(),i=t.endsWith("/")||t.endsWith(".html")?e:e.replace(/(?:(^\.+)\/)?.*$/,`$1${t.replace(/(\.md)?$/,a.value.cleanUrls?"":".html")}${n}${s}`);return me(i)}function re({correspondingLink:e=!1}={}){const{site:t,localeIndex:n,page:s,theme:o,hash:a}=T(),i=V(()=>{var u,f;return{label:(u=t.value.locales[n.value])==null?void 0:u.label,link:((f=t.value.locales[n.value])==null?void 0:f.link)||(n.value==="root"?"/":`/${n.value}/`)}});return{localeLinks:V(()=>Object.entries(t.value.locales).flatMap(([u,f])=>i.value.label===f.label?[]:{text:f.label,link:Ot(f.link||(u==="root"?"/":`/${u}/`),o.value.i18nRouting!==!1&&e,s.value.relativePath.slice(i.value.link.length-1),!t.value.cleanUrls)+a.value})),currentLang:i}}function Ot(e,t,n,s){return t?e.replace(/\/$/,"")+Se(n.replace(/(^|\/)index\.md$/,"$1").replace(/\.md$/,s?".html":"")):e}const Dt=e=>(z("data-v-d6be1790"),e=e(),j(),e),Ft={class:"NotFound"},zt={class:"code"},jt={class:"title"},Ut=Dt(()=>h("div",{class:"divider"},null,-1)),qt={class:"quote"},Gt={class:"action"},Rt=["href","aria-label"],xt=k({__name:"NotFound",setup(e){const{theme:t}=T(),{currentLang:n}=re();return(s,o)=>{var a,i,c,u,f;return r(),p("div",Ft,[h("p",zt,M(((a=l(t).notFound)==null?void 0:a.code)??"404"),1),h("h1",jt,M(((i=l(t).notFound)==null?void 0:i.title)??"PAGE NOT FOUND"),1),Ut,h("blockquote",qt,M(((c=l(t).notFound)==null?void 0:c.quote)??"But if you don't change your direction, and if you keep looking, you may end up where you are heading."),1),h("div",Gt,[h("a",{class:"link",href:l(me)(l(n).link),"aria-label":((u=l(t).notFound)==null?void 0:u.linkLabel)??"go to home"},M(((f=l(t).notFound)==null?void 0:f.linkText)??"Take me home"),9,Rt)])])}}}),Kt=L(xt,[["__scopeId","data-v-d6be1790"]]);function st(e,t){if(Array.isArray(e))return de(e);if(e==null)return[];t=Se(t);const n=Object.keys(e).sort((o,a)=>a.split("/").length-o.split("/").length).find(o=>t.startsWith(Se(o))),s=n?e[n]:[];return Array.isArray(s)?de(s):de(s.items,s.base)}function Wt(e){const t=[];let n=0;for(const s in e){const o=e[s];if(o.items){n=t.push(o);continue}t[n]||t.push({items:[]}),t[n].items.push(o)}return t}function Jt(e){const t=[];function n(s){for(const o of s)o.text&&o.link&&t.push({text:o.text,link:o.link,docFooterText:o.docFooterText}),o.items&&n(o.items)}return n(e),t}function we(e,t){return Array.isArray(t)?t.some(n=>we(e,n)):ee(e,t.link)?!0:t.items?we(e,t.items):!1}function de(e,t){return[...e].map(n=>{const s={...n},o=s.base||t;return o&&s.link&&(s.link=o+s.link),s.items&&(s.items=de(s.items,o)),s})}function Y(){const{frontmatter:e,page:t,theme:n}=T(),s=Le("(min-width: 960px)"),o=I(!1),a=V(()=>{const N=n.value.sidebar,w=t.value.relativePath;return N?st(N,w):[]}),i=I(a.value);X(a,(N,w)=>{JSON.stringify(N)!==JSON.stringify(w)&&(i.value=a.value)});const c=V(()=>e.value.sidebar!==!1&&i.value.length>0&&e.value.layout!=="home"),u=V(()=>f?e.value.aside==null?n.value.aside==="left":e.value.aside==="left":!1),f=V(()=>e.value.layout==="home"?!1:e.value.aside!=null?!!e.value.aside:n.value.aside!==!1),_=V(()=>c.value&&s.value),m=V(()=>c.value?Wt(i.value):[]);function P(){o.value=!0}function b(){o.value=!1}function $(){o.value?b():P()}return{isOpen:o,sidebar:i,sidebarGroups:m,hasSidebar:c,hasAside:f,leftAside:u,isSidebarEnabled:_,open:P,close:b,toggle:$}}function Xt(e,t){let n;_e(()=>{n=e.value?document.activeElement:void 0}),te(()=>{window.addEventListener("keyup",s)}),Me(()=>{window.removeEventListener("keyup",s)});function s(o){o.key==="Escape"&&e.value&&(t(),n==null||n.focus())}}function Yt(e){const{page:t,hash:n}=T(),s=I(!1),o=V(()=>e.value.collapsed!=null),a=V(()=>!!e.value.link),i=I(!1),c=()=>{i.value=ee(t.value.relativePath,e.value.link)};X([t,e,n],c),te(c);const u=V(()=>i.value?!0:e.value.items?we(t.value.relativePath,e.value.items):!1),f=V(()=>!!(e.value.items&&e.value.items.length));_e(()=>{s.value=!!(o.value&&e.value.collapsed)}),Je(()=>{(i.value||u.value)&&(s.value=!1)});function _(){o.value&&(s.value=!s.value)}return{collapsed:s,collapsible:o,isLink:a,isActiveLink:i,hasActiveLink:u,hasChildren:f,toggle:_}}function Qt(){const{hasSidebar:e}=Y(),t=Le("(min-width: 960px)"),n=Le("(min-width: 1280px)");return{isAsideEnabled:V(()=>!n.value&&!t.value?!1:e.value?n.value:t.value)}}const Ie=[];function ot(e){return typeof e.outline=="object"&&!Array.isArray(e.outline)&&e.outline.label||e.outlineTitle||"On this page"}function He(e){const t=[...document.querySelectorAll(".VPDoc :where(h1,h2,h3,h4,h5,h6)")].filter(n=>n.id&&n.hasChildNodes()).map(n=>{const s=Number(n.tagName[1]);return{element:n,title:Zt(n),link:"#"+n.id,level:s}});return en(t,e)}function Zt(e){let t="";for(const n of e.childNodes)if(n.nodeType===1){if(n.classList.contains("VPBadge")||n.classList.contains("header-anchor")||n.classList.contains("ignore-header"))continue;t+=n.textContent}else n.nodeType===3&&(t+=n.textContent);return t.trim()}function en(e,t){if(t===!1)return[];const n=(typeof t=="object"&&!Array.isArray(t)?t.level:t)||2,[s,o]=typeof n=="number"?[n,n]:n==="deep"?[2,6]:n;e=e.filter(i=>i.level>=s&&i.level<=o),Ie.length=0;for(const{element:i,link:c}of e)Ie.push({element:i,link:c});const a=[];e:for(let i=0;i=0;u--){const f=e[u];if(f.level{requestAnimationFrame(a),window.addEventListener("scroll",s)}),gt(()=>{i(location.hash)}),Me(()=>{window.removeEventListener("scroll",s)});function a(){if(!n.value)return;const c=window.scrollY,u=window.innerHeight,f=document.body.offsetHeight,_=Math.abs(c+u-f)<1,m=Ie.map(({element:b,link:$})=>({link:$,top:nn(b)})).filter(({top:b})=>!Number.isNaN(b)).sort((b,$)=>b.top-$.top);if(!m.length){i(null);return}if(c<1){i(null);return}if(_){i(m[m.length-1].link);return}let P=null;for(const{link:b,top:$}of m){if($>c+kt()+4)break;P=b}i(P)}function i(c){o&&o.classList.remove("active"),c==null?o=null:o=e.value.querySelector(`a[href="${decodeURIComponent(c)}"]`);const u=o;u?(u.classList.add("active"),t.value.style.top=u.offsetTop+39+"px",t.value.style.opacity="1"):(t.value.style.top="33px",t.value.style.opacity="0")}}function nn(e){let t=0;for(;e!==document.body;){if(e===null)return NaN;t+=e.offsetTop,e=e.offsetParent}return t}const sn=["href","title"],on=k({__name:"VPDocOutlineItem",props:{headers:{},root:{type:Boolean}},setup(e){function t({target:n}){const s=n.href.split("#")[1],o=document.getElementById(decodeURIComponent(s));o==null||o.focus({preventScroll:!0})}return(n,s)=>{const o=Z("VPDocOutlineItem",!0);return r(),p("ul",{class:A(["VPDocOutlineItem",n.root?"root":"nested"])},[(r(!0),p(C,null,F(n.headers,({children:a,link:i,title:c})=>(r(),p("li",null,[h("a",{class:"outline-link",href:i,onClick:t,title:c},M(c),9,sn),a!=null&&a.length?(r(),S(o,{key:0,headers:a},null,8,["headers"])):g("",!0)]))),256))],2)}}}),at=L(on,[["__scopeId","data-v-b933a997"]]),an={class:"content"},rn={"aria-level":"2",class:"outline-title",id:"doc-outline-aria-label",role:"heading"},ln=k({__name:"VPDocAsideOutline",setup(e){const{frontmatter:t,theme:n}=T(),s=Xe([]);ge(()=>{s.value=He(t.value.outline??n.value.outline)});const o=I(),a=I();return tn(o,a),(i,c)=>(r(),p("nav",{"aria-labelledby":"doc-outline-aria-label",class:A(["VPDocAsideOutline",{"has-outline":s.value.length>0}]),ref_key:"container",ref:o},[h("div",an,[h("div",{class:"outline-marker",ref_key:"marker",ref:a},null,512),h("div",rn,M(l(ot)(l(n))),1),y(at,{headers:s.value,root:!0},null,8,["headers"])])],2))}}),cn=L(ln,[["__scopeId","data-v-a5bbad30"]]),un={class:"VPDocAsideCarbonAds"},dn=k({__name:"VPDocAsideCarbonAds",props:{carbonAds:{}},setup(e){const t=()=>null;return(n,s)=>(r(),p("div",un,[y(l(t),{"carbon-ads":n.carbonAds},null,8,["carbon-ads"])]))}}),hn=e=>(z("data-v-3f215769"),e=e(),j(),e),pn={class:"VPDocAside"},vn=hn(()=>h("div",{class:"spacer"},null,-1)),fn=k({__name:"VPDocAside",setup(e){const{theme:t}=T();return(n,s)=>(r(),p("div",pn,[d(n.$slots,"aside-top",{},void 0,!0),d(n.$slots,"aside-outline-before",{},void 0,!0),y(cn),d(n.$slots,"aside-outline-after",{},void 0,!0),vn,d(n.$slots,"aside-ads-before",{},void 0,!0),l(t).carbonAds?(r(),S(dn,{key:0,"carbon-ads":l(t).carbonAds},null,8,["carbon-ads"])):g("",!0),d(n.$slots,"aside-ads-after",{},void 0,!0),d(n.$slots,"aside-bottom",{},void 0,!0)]))}}),mn=L(fn,[["__scopeId","data-v-3f215769"]]);function _n(){const{theme:e,page:t}=T();return V(()=>{const{text:n="Edit this page",pattern:s=""}=e.value.editLink||{};let o;return typeof s=="function"?o=s(t.value):o=s.replace(/:path/g,t.value.filePath),{url:o,text:n}})}function gn(){const{page:e,theme:t,frontmatter:n}=T();return V(()=>{var f,_,m,P,b,$,N,w;const s=st(t.value.sidebar,e.value.relativePath),o=Jt(s),a=kn(o,U=>U.link.replace(/[?#].*$/,"")),i=a.findIndex(U=>ee(e.value.relativePath,U.link)),c=((f=t.value.docFooter)==null?void 0:f.prev)===!1&&!n.value.prev||n.value.prev===!1,u=((_=t.value.docFooter)==null?void 0:_.next)===!1&&!n.value.next||n.value.next===!1;return{prev:c?void 0:{text:(typeof n.value.prev=="string"?n.value.prev:typeof n.value.prev=="object"?n.value.prev.text:void 0)??((m=a[i-1])==null?void 0:m.docFooterText)??((P=a[i-1])==null?void 0:P.text),link:(typeof n.value.prev=="object"?n.value.prev.link:void 0)??((b=a[i-1])==null?void 0:b.link)},next:u?void 0:{text:(typeof n.value.next=="string"?n.value.next:typeof n.value.next=="object"?n.value.next.text:void 0)??(($=a[i+1])==null?void 0:$.docFooterText)??((N=a[i+1])==null?void 0:N.text),link:(typeof n.value.next=="object"?n.value.next.link:void 0)??((w=a[i+1])==null?void 0:w.link)}}})}function kn(e,t){const n=new Set;return e.filter(s=>{const o=t(s);return n.has(o)?!1:n.add(o)})}const W=k({__name:"VPLink",props:{tag:{},href:{},noIcon:{type:Boolean},target:{},rel:{}},setup(e){const t=e,n=V(()=>t.tag??(t.href?"a":"span")),s=V(()=>t.href&&Ye.test(t.href)||t.target==="_blank");return(o,a)=>(r(),S(oe(n.value),{class:A(["VPLink",{link:o.href,"vp-external-link-icon":s.value,"no-icon":o.noIcon}]),href:o.href?l(Ce)(o.href):void 0,target:o.target??(s.value?"_blank":void 0),rel:o.rel??(s.value?"noreferrer":void 0)},{default:v(()=>[d(o.$slots,"default")]),_:3},8,["class","href","target","rel"]))}}),bn={class:"VPLastUpdated"},$n=["datetime"],yn=k({__name:"VPDocFooterLastUpdated",setup(e){const{theme:t,page:n,frontmatter:s,lang:o}=T(),a=V(()=>new Date(s.value.lastUpdated??n.value.lastUpdated)),i=V(()=>a.value.toISOString()),c=I("");return te(()=>{_e(()=>{var u,f,_;c.value=new Intl.DateTimeFormat((f=(u=t.value.lastUpdated)==null?void 0:u.formatOptions)!=null&&f.forceLocale?o.value:void 0,((_=t.value.lastUpdated)==null?void 0:_.formatOptions)??{dateStyle:"short",timeStyle:"short"}).format(a.value)})}),(u,f)=>{var _;return r(),p("p",bn,[J(M(((_=l(t).lastUpdated)==null?void 0:_.text)||l(t).lastUpdatedText||"Last updated")+": ",1),h("time",{datetime:i.value},M(c.value),9,$n)])}}}),Pn=L(yn,[["__scopeId","data-v-7e05ebdb"]]),it=e=>(z("data-v-d4a0bba5"),e=e(),j(),e),Vn={key:0,class:"VPDocFooter"},Ln={key:0,class:"edit-info"},Sn={key:0,class:"edit-link"},wn=it(()=>h("span",{class:"vpi-square-pen edit-link-icon"},null,-1)),In={key:1,class:"last-updated"},Tn={key:1,class:"prev-next","aria-labelledby":"doc-footer-aria-label"},Nn=it(()=>h("span",{class:"visually-hidden",id:"doc-footer-aria-label"},"Pager",-1)),Mn={class:"pager"},An=["innerHTML"],Cn=["innerHTML"],Hn={class:"pager"},Bn=["innerHTML"],En=["innerHTML"],On=k({__name:"VPDocFooter",setup(e){const{theme:t,page:n,frontmatter:s}=T(),o=_n(),a=gn(),i=V(()=>t.value.editLink&&s.value.editLink!==!1),c=V(()=>n.value.lastUpdated&&s.value.lastUpdated!==!1),u=V(()=>i.value||c.value||a.value.prev||a.value.next);return(f,_)=>{var m,P,b,$;return u.value?(r(),p("footer",Vn,[d(f.$slots,"doc-footer-before",{},void 0,!0),i.value||c.value?(r(),p("div",Ln,[i.value?(r(),p("div",Sn,[y(W,{class:"edit-link-button",href:l(o).url,"no-icon":!0},{default:v(()=>[wn,J(" "+M(l(o).text),1)]),_:1},8,["href"])])):g("",!0),c.value?(r(),p("div",In,[y(Pn)])):g("",!0)])):g("",!0),(m=l(a).prev)!=null&&m.link||(P=l(a).next)!=null&&P.link?(r(),p("nav",Tn,[Nn,h("div",Mn,[(b=l(a).prev)!=null&&b.link?(r(),S(W,{key:0,class:"pager-link prev",href:l(a).prev.link},{default:v(()=>{var N;return[h("span",{class:"desc",innerHTML:((N=l(t).docFooter)==null?void 0:N.prev)||"Previous page"},null,8,An),h("span",{class:"title",innerHTML:l(a).prev.text},null,8,Cn)]}),_:1},8,["href"])):g("",!0)]),h("div",Hn,[($=l(a).next)!=null&&$.link?(r(),S(W,{key:0,class:"pager-link next",href:l(a).next.link},{default:v(()=>{var N;return[h("span",{class:"desc",innerHTML:((N=l(t).docFooter)==null?void 0:N.next)||"Next page"},null,8,Bn),h("span",{class:"title",innerHTML:l(a).next.text},null,8,En)]}),_:1},8,["href"])):g("",!0)])])):g("",!0)])):g("",!0)}}}),Dn=L(On,[["__scopeId","data-v-d4a0bba5"]]),Fn=e=>(z("data-v-39a288b8"),e=e(),j(),e),zn={class:"container"},jn=Fn(()=>h("div",{class:"aside-curtain"},null,-1)),Un={class:"aside-container"},qn={class:"aside-content"},Gn={class:"content"},Rn={class:"content-container"},xn={class:"main"},Kn=k({__name:"VPDoc",setup(e){const{theme:t}=T(),n=ie(),{hasSidebar:s,hasAside:o,leftAside:a}=Y(),i=V(()=>n.path.replace(/[./]+/g,"_").replace(/_html$/,""));return(c,u)=>{const f=Z("Content");return r(),p("div",{class:A(["VPDoc",{"has-sidebar":l(s),"has-aside":l(o)}])},[d(c.$slots,"doc-top",{},void 0,!0),h("div",zn,[l(o)?(r(),p("div",{key:0,class:A(["aside",{"left-aside":l(a)}])},[jn,h("div",Un,[h("div",qn,[y(mn,null,{"aside-top":v(()=>[d(c.$slots,"aside-top",{},void 0,!0)]),"aside-bottom":v(()=>[d(c.$slots,"aside-bottom",{},void 0,!0)]),"aside-outline-before":v(()=>[d(c.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":v(()=>[d(c.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":v(()=>[d(c.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":v(()=>[d(c.$slots,"aside-ads-after",{},void 0,!0)]),_:3})])])],2)):g("",!0),h("div",Gn,[h("div",Rn,[d(c.$slots,"doc-before",{},void 0,!0),h("main",xn,[y(f,{class:A(["vp-doc",[i.value,l(t).externalLinkIcon&&"external-link-icon-enabled"]])},null,8,["class"])]),y(Dn,null,{"doc-footer-before":v(()=>[d(c.$slots,"doc-footer-before",{},void 0,!0)]),_:3}),d(c.$slots,"doc-after",{},void 0,!0)])])]),d(c.$slots,"doc-bottom",{},void 0,!0)],2)}}}),Wn=L(Kn,[["__scopeId","data-v-39a288b8"]]),Jn=k({__name:"VPButton",props:{tag:{},size:{default:"medium"},theme:{default:"brand"},text:{},href:{},target:{},rel:{}},setup(e){const t=e,n=V(()=>t.href&&Ye.test(t.href)),s=V(()=>t.tag||t.href?"a":"button");return(o,a)=>(r(),S(oe(s.value),{class:A(["VPButton",[o.size,o.theme]]),href:o.href?l(Ce)(o.href):void 0,target:t.target??(n.value?"_blank":void 0),rel:t.rel??(n.value?"noreferrer":void 0)},{default:v(()=>[J(M(o.text),1)]),_:1},8,["class","href","target","rel"]))}}),Xn=L(Jn,[["__scopeId","data-v-cad61b99"]]),Yn=["src","alt"],Qn=k({inheritAttrs:!1,__name:"VPImage",props:{image:{},alt:{}},setup(e){return(t,n)=>{const s=Z("VPImage",!0);return t.image?(r(),p(C,{key:0},[typeof t.image=="string"||"src"in t.image?(r(),p("img",ue({key:0,class:"VPImage"},typeof t.image=="string"?t.$attrs:{...t.image,...t.$attrs},{src:l(me)(typeof t.image=="string"?t.image:t.image.src),alt:t.alt??(typeof t.image=="string"?"":t.image.alt||"")}),null,16,Yn)):(r(),p(C,{key:1},[y(s,ue({class:"dark",image:t.image.dark,alt:t.image.alt},t.$attrs),null,16,["image","alt"]),y(s,ue({class:"light",image:t.image.light,alt:t.image.alt},t.$attrs),null,16,["image","alt"])],64))],64)):g("",!0)}}}),pe=L(Qn,[["__scopeId","data-v-8426fc1a"]]),Zn=e=>(z("data-v-303bb580"),e=e(),j(),e),es={class:"container"},ts={class:"main"},ns={key:0,class:"name"},ss=["innerHTML"],os=["innerHTML"],as=["innerHTML"],is={key:0,class:"actions"},rs={key:0,class:"image"},ls={class:"image-container"},cs=Zn(()=>h("div",{class:"image-bg"},null,-1)),us=k({__name:"VPHero",props:{name:{},text:{},tagline:{},image:{},actions:{}},setup(e){const t=ke("hero-image-slot-exists");return(n,s)=>(r(),p("div",{class:A(["VPHero",{"has-image":n.image||l(t)}])},[h("div",es,[h("div",ts,[d(n.$slots,"home-hero-info-before",{},void 0,!0),d(n.$slots,"home-hero-info",{},()=>[n.name?(r(),p("h1",ns,[h("span",{innerHTML:n.name,class:"clip"},null,8,ss)])):g("",!0),n.text?(r(),p("p",{key:1,innerHTML:n.text,class:"text"},null,8,os)):g("",!0),n.tagline?(r(),p("p",{key:2,innerHTML:n.tagline,class:"tagline"},null,8,as)):g("",!0)],!0),d(n.$slots,"home-hero-info-after",{},void 0,!0),n.actions?(r(),p("div",is,[(r(!0),p(C,null,F(n.actions,o=>(r(),p("div",{key:o.link,class:"action"},[y(Xn,{tag:"a",size:"medium",theme:o.theme,text:o.text,href:o.link,target:o.target,rel:o.rel},null,8,["theme","text","href","target","rel"])]))),128))])):g("",!0),d(n.$slots,"home-hero-actions-after",{},void 0,!0)]),n.image||l(t)?(r(),p("div",rs,[h("div",ls,[cs,d(n.$slots,"home-hero-image",{},()=>[n.image?(r(),S(pe,{key:0,class:"image-src",image:n.image},null,8,["image"])):g("",!0)],!0)])])):g("",!0)])],2))}}),ds=L(us,[["__scopeId","data-v-303bb580"]]),hs=k({__name:"VPHomeHero",setup(e){const{frontmatter:t}=T();return(n,s)=>l(t).hero?(r(),S(ds,{key:0,class:"VPHomeHero",name:l(t).hero.name,text:l(t).hero.text,tagline:l(t).hero.tagline,image:l(t).hero.image,actions:l(t).hero.actions},{"home-hero-info-before":v(()=>[d(n.$slots,"home-hero-info-before")]),"home-hero-info":v(()=>[d(n.$slots,"home-hero-info")]),"home-hero-info-after":v(()=>[d(n.$slots,"home-hero-info-after")]),"home-hero-actions-after":v(()=>[d(n.$slots,"home-hero-actions-after")]),"home-hero-image":v(()=>[d(n.$slots,"home-hero-image")]),_:3},8,["name","text","tagline","image","actions"])):g("",!0)}}),ps=e=>(z("data-v-a3976bdc"),e=e(),j(),e),vs={class:"box"},fs={key:0,class:"icon"},ms=["innerHTML"],_s=["innerHTML"],gs=["innerHTML"],ks={key:4,class:"link-text"},bs={class:"link-text-value"},$s=ps(()=>h("span",{class:"vpi-arrow-right link-text-icon"},null,-1)),ys=k({__name:"VPFeature",props:{icon:{},title:{},details:{},link:{},linkText:{},rel:{},target:{}},setup(e){return(t,n)=>(r(),S(W,{class:"VPFeature",href:t.link,rel:t.rel,target:t.target,"no-icon":!0,tag:t.link?"a":"div"},{default:v(()=>[h("article",vs,[typeof t.icon=="object"&&t.icon.wrap?(r(),p("div",fs,[y(pe,{image:t.icon,alt:t.icon.alt,height:t.icon.height||48,width:t.icon.width||48},null,8,["image","alt","height","width"])])):typeof t.icon=="object"?(r(),S(pe,{key:1,image:t.icon,alt:t.icon.alt,height:t.icon.height||48,width:t.icon.width||48},null,8,["image","alt","height","width"])):t.icon?(r(),p("div",{key:2,class:"icon",innerHTML:t.icon},null,8,ms)):g("",!0),h("h2",{class:"title",innerHTML:t.title},null,8,_s),t.details?(r(),p("p",{key:3,class:"details",innerHTML:t.details},null,8,gs)):g("",!0),t.linkText?(r(),p("div",ks,[h("p",bs,[J(M(t.linkText)+" ",1),$s])])):g("",!0)])]),_:1},8,["href","rel","target","tag"]))}}),Ps=L(ys,[["__scopeId","data-v-a3976bdc"]]),Vs={key:0,class:"VPFeatures"},Ls={class:"container"},Ss={class:"items"},ws=k({__name:"VPFeatures",props:{features:{}},setup(e){const t=e,n=V(()=>{const s=t.features.length;if(s){if(s===2)return"grid-2";if(s===3)return"grid-3";if(s%3===0)return"grid-6";if(s>3)return"grid-4"}else return});return(s,o)=>s.features?(r(),p("div",Vs,[h("div",Ls,[h("div",Ss,[(r(!0),p(C,null,F(s.features,a=>(r(),p("div",{key:a.title,class:A(["item",[n.value]])},[y(Ps,{icon:a.icon,title:a.title,details:a.details,link:a.link,"link-text":a.linkText,rel:a.rel,target:a.target},null,8,["icon","title","details","link","link-text","rel","target"])],2))),128))])])])):g("",!0)}}),Is=L(ws,[["__scopeId","data-v-a6181336"]]),Ts=k({__name:"VPHomeFeatures",setup(e){const{frontmatter:t}=T();return(n,s)=>l(t).features?(r(),S(Is,{key:0,class:"VPHomeFeatures",features:l(t).features},null,8,["features"])):g("",!0)}}),Ns=k({__name:"VPHomeContent",setup(e){const{width:t}=bt({initialWidth:0,includeScrollbar:!1});return(n,s)=>(r(),p("div",{class:"vp-doc container",style:Qe(l(t)?{"--vp-offset":`calc(50% - ${l(t)/2}px)`}:{})},[d(n.$slots,"default",{},void 0,!0)],4))}}),Ms=L(Ns,[["__scopeId","data-v-8e2d4988"]]),As={class:"VPHome"},Cs=k({__name:"VPHome",setup(e){const{frontmatter:t}=T();return(n,s)=>{const o=Z("Content");return r(),p("div",As,[d(n.$slots,"home-hero-before",{},void 0,!0),y(hs,null,{"home-hero-info-before":v(()=>[d(n.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":v(()=>[d(n.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":v(()=>[d(n.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":v(()=>[d(n.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":v(()=>[d(n.$slots,"home-hero-image",{},void 0,!0)]),_:3}),d(n.$slots,"home-hero-after",{},void 0,!0),d(n.$slots,"home-features-before",{},void 0,!0),y(Ts),d(n.$slots,"home-features-after",{},void 0,!0),l(t).markdownStyles!==!1?(r(),S(Ms,{key:0},{default:v(()=>[y(o)]),_:1})):(r(),S(o,{key:1}))])}}}),Hs=L(Cs,[["__scopeId","data-v-686f80a6"]]),Bs={},Es={class:"VPPage"};function Os(e,t){const n=Z("Content");return r(),p("div",Es,[d(e.$slots,"page-top"),y(n),d(e.$slots,"page-bottom")])}const Ds=L(Bs,[["render",Os]]),Fs=k({__name:"VPContent",setup(e){const{page:t,frontmatter:n}=T(),{hasSidebar:s}=Y();return(o,a)=>(r(),p("div",{class:A(["VPContent",{"has-sidebar":l(s),"is-home":l(n).layout==="home"}]),id:"VPContent"},[l(t).isNotFound?d(o.$slots,"not-found",{key:0},()=>[y(Kt)],!0):l(n).layout==="page"?(r(),S(Ds,{key:1},{"page-top":v(()=>[d(o.$slots,"page-top",{},void 0,!0)]),"page-bottom":v(()=>[d(o.$slots,"page-bottom",{},void 0,!0)]),_:3})):l(n).layout==="home"?(r(),S(Hs,{key:2},{"home-hero-before":v(()=>[d(o.$slots,"home-hero-before",{},void 0,!0)]),"home-hero-info-before":v(()=>[d(o.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":v(()=>[d(o.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":v(()=>[d(o.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":v(()=>[d(o.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":v(()=>[d(o.$slots,"home-hero-image",{},void 0,!0)]),"home-hero-after":v(()=>[d(o.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":v(()=>[d(o.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":v(()=>[d(o.$slots,"home-features-after",{},void 0,!0)]),_:3})):l(n).layout&&l(n).layout!=="doc"?(r(),S(oe(l(n).layout),{key:3})):(r(),S(Wn,{key:4},{"doc-top":v(()=>[d(o.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":v(()=>[d(o.$slots,"doc-bottom",{},void 0,!0)]),"doc-footer-before":v(()=>[d(o.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":v(()=>[d(o.$slots,"doc-before",{},void 0,!0)]),"doc-after":v(()=>[d(o.$slots,"doc-after",{},void 0,!0)]),"aside-top":v(()=>[d(o.$slots,"aside-top",{},void 0,!0)]),"aside-outline-before":v(()=>[d(o.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":v(()=>[d(o.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":v(()=>[d(o.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":v(()=>[d(o.$slots,"aside-ads-after",{},void 0,!0)]),"aside-bottom":v(()=>[d(o.$slots,"aside-bottom",{},void 0,!0)]),_:3}))],2))}}),zs=L(Fs,[["__scopeId","data-v-1428d186"]]),js={class:"container"},Us=["innerHTML"],qs=["innerHTML"],Gs=k({__name:"VPFooter",setup(e){const{theme:t,frontmatter:n}=T(),{hasSidebar:s}=Y();return(o,a)=>l(t).footer&&l(n).footer!==!1?(r(),p("footer",{key:0,class:A(["VPFooter",{"has-sidebar":l(s)}])},[h("div",js,[l(t).footer.message?(r(),p("p",{key:0,class:"message",innerHTML:l(t).footer.message},null,8,Us)):g("",!0),l(t).footer.copyright?(r(),p("p",{key:1,class:"copyright",innerHTML:l(t).footer.copyright},null,8,qs)):g("",!0)])],2)):g("",!0)}}),Rs=L(Gs,[["__scopeId","data-v-e315a0ad"]]);function xs(){const{theme:e,frontmatter:t}=T(),n=Xe([]),s=V(()=>n.value.length>0);return ge(()=>{n.value=He(t.value.outline??e.value.outline)}),{headers:n,hasLocalNav:s}}const Ks=e=>(z("data-v-17a5e62e"),e=e(),j(),e),Ws={class:"menu-text"},Js=Ks(()=>h("span",{class:"vpi-chevron-right icon"},null,-1)),Xs={class:"header"},Ys={class:"outline"},Qs=k({__name:"VPLocalNavOutlineDropdown",props:{headers:{},navHeight:{}},setup(e){const t=e,{theme:n}=T(),s=I(!1),o=I(0),a=I(),i=I();function c(m){var P;(P=a.value)!=null&&P.contains(m.target)||(s.value=!1)}X(s,m=>{if(m){document.addEventListener("click",c);return}document.removeEventListener("click",c)}),$t("Escape",()=>{s.value=!1}),ge(()=>{s.value=!1});function u(){s.value=!s.value,o.value=window.innerHeight+Math.min(window.scrollY-t.navHeight,0)}function f(m){m.target.classList.contains("outline-link")&&(i.value&&(i.value.style.transition="none"),Ae(()=>{s.value=!1}))}function _(){s.value=!1,window.scrollTo({top:0,left:0,behavior:"smooth"})}return(m,P)=>(r(),p("div",{class:"VPLocalNavOutlineDropdown",style:Qe({"--vp-vh":o.value+"px"}),ref_key:"main",ref:a},[m.headers.length>0?(r(),p("button",{key:0,onClick:u,class:A({open:s.value})},[h("span",Ws,M(l(ot)(l(n))),1),Js],2)):(r(),p("button",{key:1,onClick:_},M(l(n).returnToTopLabel||"Return to top"),1)),y(Ne,{name:"flyout"},{default:v(()=>[s.value?(r(),p("div",{key:0,ref_key:"items",ref:i,class:"items",onClick:f},[h("div",Xs,[h("a",{class:"top-link",href:"#",onClick:_},M(l(n).returnToTopLabel||"Return to top"),1)]),h("div",Ys,[y(at,{headers:m.headers},null,8,["headers"])])],512)):g("",!0)]),_:1})],4))}}),Zs=L(Qs,[["__scopeId","data-v-17a5e62e"]]),eo=e=>(z("data-v-a6f0e41e"),e=e(),j(),e),to={class:"container"},no=["aria-expanded"],so=eo(()=>h("span",{class:"vpi-align-left menu-icon"},null,-1)),oo={class:"menu-text"},ao=k({__name:"VPLocalNav",props:{open:{type:Boolean}},emits:["open-menu"],setup(e){const{theme:t,frontmatter:n}=T(),{hasSidebar:s}=Y(),{headers:o}=xs(),{y:a}=Ze(),i=I(0);te(()=>{i.value=parseInt(getComputedStyle(document.documentElement).getPropertyValue("--vp-nav-height"))}),ge(()=>{o.value=He(n.value.outline??t.value.outline)});const c=V(()=>o.value.length===0),u=V(()=>c.value&&!s.value),f=V(()=>({VPLocalNav:!0,"has-sidebar":s.value,empty:c.value,fixed:u.value}));return(_,m)=>l(n).layout!=="home"&&(!u.value||l(a)>=i.value)?(r(),p("div",{key:0,class:A(f.value)},[h("div",to,[l(s)?(r(),p("button",{key:0,class:"menu","aria-expanded":_.open,"aria-controls":"VPSidebarNav",onClick:m[0]||(m[0]=P=>_.$emit("open-menu"))},[so,h("span",oo,M(l(t).sidebarMenuLabel||"Menu"),1)],8,no)):g("",!0),y(Zs,{headers:l(o),navHeight:i.value},null,8,["headers","navHeight"])])],2)):g("",!0)}}),io=L(ao,[["__scopeId","data-v-a6f0e41e"]]);function ro(){const e=I(!1);function t(){e.value=!0,window.addEventListener("resize",o)}function n(){e.value=!1,window.removeEventListener("resize",o)}function s(){e.value?n():t()}function o(){window.outerWidth>=768&&n()}const a=ie();return X(()=>a.path,n),{isScreenOpen:e,openScreen:t,closeScreen:n,toggleScreen:s}}const lo={},co={class:"VPSwitch",type:"button",role:"switch"},uo={class:"check"},ho={key:0,class:"icon"};function po(e,t){return r(),p("button",co,[h("span",uo,[e.$slots.default?(r(),p("span",ho,[d(e.$slots,"default",{},void 0,!0)])):g("",!0)])])}const vo=L(lo,[["render",po],["__scopeId","data-v-1d5665e3"]]),rt=e=>(z("data-v-d1f28634"),e=e(),j(),e),fo=rt(()=>h("span",{class:"vpi-sun sun"},null,-1)),mo=rt(()=>h("span",{class:"vpi-moon moon"},null,-1)),_o=k({__name:"VPSwitchAppearance",setup(e){const{isDark:t,theme:n}=T(),s=ke("toggle-appearance",()=>{t.value=!t.value}),o=V(()=>t.value?n.value.lightModeSwitchTitle||"Switch to light theme":n.value.darkModeSwitchTitle||"Switch to dark theme");return(a,i)=>(r(),S(vo,{title:o.value,class:"VPSwitchAppearance","aria-checked":l(t),onClick:l(s)},{default:v(()=>[fo,mo]),_:1},8,["title","aria-checked","onClick"]))}}),Be=L(_o,[["__scopeId","data-v-d1f28634"]]),go={key:0,class:"VPNavBarAppearance"},ko=k({__name:"VPNavBarAppearance",setup(e){const{site:t}=T();return(n,s)=>l(t).appearance&&l(t).appearance!=="force-dark"?(r(),p("div",go,[y(Be)])):g("",!0)}}),bo=L(ko,[["__scopeId","data-v-e6aabb21"]]),Ee=I();let lt=!1,ye=0;function $o(e){const t=I(!1);if(be){!lt&&yo(),ye++;const n=X(Ee,s=>{var o,a,i;s===e.el.value||(o=e.el.value)!=null&&o.contains(s)?(t.value=!0,(a=e.onFocus)==null||a.call(e)):(t.value=!1,(i=e.onBlur)==null||i.call(e))});Me(()=>{n(),ye--,ye||Po()})}return yt(t)}function yo(){document.addEventListener("focusin",ct),lt=!0,Ee.value=document.activeElement}function Po(){document.removeEventListener("focusin",ct)}function ct(){Ee.value=document.activeElement}const Vo={class:"VPMenuLink"},Lo=k({__name:"VPMenuLink",props:{item:{}},setup(e){const{page:t}=T();return(n,s)=>(r(),p("div",Vo,[y(W,{class:A({active:l(ee)(l(t).relativePath,n.item.activeMatch||n.item.link,!!n.item.activeMatch)}),href:n.item.link,target:n.item.target,rel:n.item.rel},{default:v(()=>[J(M(n.item.text),1)]),_:1},8,["class","href","target","rel"])]))}}),$e=L(Lo,[["__scopeId","data-v-43f1e123"]]),So={class:"VPMenuGroup"},wo={key:0,class:"title"},Io=k({__name:"VPMenuGroup",props:{text:{},items:{}},setup(e){return(t,n)=>(r(),p("div",So,[t.text?(r(),p("p",wo,M(t.text),1)):g("",!0),(r(!0),p(C,null,F(t.items,s=>(r(),p(C,null,["link"in s?(r(),S($e,{key:0,item:s},null,8,["item"])):g("",!0)],64))),256))]))}}),To=L(Io,[["__scopeId","data-v-69e747b5"]]),No={class:"VPMenu"},Mo={key:0,class:"items"},Ao=k({__name:"VPMenu",props:{items:{}},setup(e){return(t,n)=>(r(),p("div",No,[t.items?(r(),p("div",Mo,[(r(!0),p(C,null,F(t.items,s=>(r(),p(C,{key:s.text},["link"in s?(r(),S($e,{key:0,item:s},null,8,["item"])):(r(),S(To,{key:1,text:s.text,items:s.items},null,8,["text","items"]))],64))),128))])):g("",!0),d(t.$slots,"default",{},void 0,!0)]))}}),Co=L(Ao,[["__scopeId","data-v-e7ea1737"]]),Ho=e=>(z("data-v-b6c34ac9"),e=e(),j(),e),Bo=["aria-expanded","aria-label"],Eo={key:0,class:"text"},Oo=["innerHTML"],Do=Ho(()=>h("span",{class:"vpi-chevron-down text-icon"},null,-1)),Fo={key:1,class:"vpi-more-horizontal icon"},zo={class:"menu"},jo=k({__name:"VPFlyout",props:{icon:{},button:{},label:{},items:{}},setup(e){const t=I(!1),n=I();$o({el:n,onBlur:s});function s(){t.value=!1}return(o,a)=>(r(),p("div",{class:"VPFlyout",ref_key:"el",ref:n,onMouseenter:a[1]||(a[1]=i=>t.value=!0),onMouseleave:a[2]||(a[2]=i=>t.value=!1)},[h("button",{type:"button",class:"button","aria-haspopup":"true","aria-expanded":t.value,"aria-label":o.label,onClick:a[0]||(a[0]=i=>t.value=!t.value)},[o.button||o.icon?(r(),p("span",Eo,[o.icon?(r(),p("span",{key:0,class:A([o.icon,"option-icon"])},null,2)):g("",!0),o.button?(r(),p("span",{key:1,innerHTML:o.button},null,8,Oo)):g("",!0),Do])):(r(),p("span",Fo))],8,Bo),h("div",zo,[y(Co,{items:o.items},{default:v(()=>[d(o.$slots,"default",{},void 0,!0)]),_:3},8,["items"])])],544))}}),Oe=L(jo,[["__scopeId","data-v-b6c34ac9"]]),Uo=["href","aria-label","innerHTML"],qo=k({__name:"VPSocialLink",props:{icon:{},link:{},ariaLabel:{}},setup(e){const t=e,n=V(()=>typeof t.icon=="object"?t.icon.svg:``);return(s,o)=>(r(),p("a",{class:"VPSocialLink no-icon",href:s.link,"aria-label":s.ariaLabel??(typeof s.icon=="string"?s.icon:""),target:"_blank",rel:"noopener",innerHTML:n.value},null,8,Uo))}}),Go=L(qo,[["__scopeId","data-v-eee4e7cb"]]),Ro={class:"VPSocialLinks"},xo=k({__name:"VPSocialLinks",props:{links:{}},setup(e){return(t,n)=>(r(),p("div",Ro,[(r(!0),p(C,null,F(t.links,({link:s,icon:o,ariaLabel:a})=>(r(),S(Go,{key:s,icon:o,link:s,ariaLabel:a},null,8,["icon","link","ariaLabel"]))),128))]))}}),De=L(xo,[["__scopeId","data-v-7bc22406"]]),Ko={key:0,class:"group translations"},Wo={class:"trans-title"},Jo={key:1,class:"group"},Xo={class:"item appearance"},Yo={class:"label"},Qo={class:"appearance-action"},Zo={key:2,class:"group"},ea={class:"item social-links"},ta=k({__name:"VPNavBarExtra",setup(e){const{site:t,theme:n}=T(),{localeLinks:s,currentLang:o}=re({correspondingLink:!0}),a=V(()=>s.value.length&&o.value.label||t.value.appearance||n.value.socialLinks);return(i,c)=>a.value?(r(),S(Oe,{key:0,class:"VPNavBarExtra",label:"extra navigation"},{default:v(()=>[l(s).length&&l(o).label?(r(),p("div",Ko,[h("p",Wo,M(l(o).label),1),(r(!0),p(C,null,F(l(s),u=>(r(),S($e,{key:u.link,item:u},null,8,["item"]))),128))])):g("",!0),l(t).appearance&&l(t).appearance!=="force-dark"?(r(),p("div",Jo,[h("div",Xo,[h("p",Yo,M(l(n).darkModeSwitchLabel||"Appearance"),1),h("div",Qo,[y(Be)])])])):g("",!0),l(n).socialLinks?(r(),p("div",Zo,[h("div",ea,[y(De,{class:"social-links-list",links:l(n).socialLinks},null,8,["links"])])])):g("",!0)]),_:1})):g("",!0)}}),na=L(ta,[["__scopeId","data-v-d0bd9dde"]]),sa=e=>(z("data-v-e5dd9c1c"),e=e(),j(),e),oa=["aria-expanded"],aa=sa(()=>h("span",{class:"container"},[h("span",{class:"top"}),h("span",{class:"middle"}),h("span",{class:"bottom"})],-1)),ia=[aa],ra=k({__name:"VPNavBarHamburger",props:{active:{type:Boolean}},emits:["click"],setup(e){return(t,n)=>(r(),p("button",{type:"button",class:A(["VPNavBarHamburger",{active:t.active}]),"aria-label":"mobile navigation","aria-expanded":t.active,"aria-controls":"VPNavScreen",onClick:n[0]||(n[0]=s=>t.$emit("click"))},ia,10,oa))}}),la=L(ra,[["__scopeId","data-v-e5dd9c1c"]]),ca=["innerHTML"],ua=k({__name:"VPNavBarMenuLink",props:{item:{}},setup(e){const{page:t}=T();return(n,s)=>(r(),S(W,{class:A({VPNavBarMenuLink:!0,active:l(ee)(l(t).relativePath,n.item.activeMatch||n.item.link,!!n.item.activeMatch)}),href:n.item.link,noIcon:n.item.noIcon,target:n.item.target,rel:n.item.rel,tabindex:"0"},{default:v(()=>[h("span",{innerHTML:n.item.text},null,8,ca)]),_:1},8,["class","href","noIcon","target","rel"]))}}),da=L(ua,[["__scopeId","data-v-9c663999"]]),ha=k({__name:"VPNavBarMenuGroup",props:{item:{}},setup(e){const t=e,{page:n}=T(),s=a=>"link"in a?ee(n.value.relativePath,a.link,!!t.item.activeMatch):a.items.some(s),o=V(()=>s(t.item));return(a,i)=>(r(),S(Oe,{class:A({VPNavBarMenuGroup:!0,active:l(ee)(l(n).relativePath,a.item.activeMatch,!!a.item.activeMatch)||o.value}),button:a.item.text,items:a.item.items},null,8,["class","button","items"]))}}),pa=e=>(z("data-v-7f418b0f"),e=e(),j(),e),va={key:0,"aria-labelledby":"main-nav-aria-label",class:"VPNavBarMenu"},fa=pa(()=>h("span",{id:"main-nav-aria-label",class:"visually-hidden"},"Main Navigation",-1)),ma=k({__name:"VPNavBarMenu",setup(e){const{theme:t}=T();return(n,s)=>l(t).nav?(r(),p("nav",va,[fa,(r(!0),p(C,null,F(l(t).nav,o=>(r(),p(C,{key:o.text},["link"in o?(r(),S(da,{key:0,item:o},null,8,["item"])):(r(),S(ha,{key:1,item:o},null,8,["item"]))],64))),128))])):g("",!0)}}),_a=L(ma,[["__scopeId","data-v-7f418b0f"]]),ga="/assets/flex-logo.BJA2J7hW.svg";function Pe(e,t){return typeof e>"u"?t:e}function Ue(e){const t=Array(e);for(let n=0;n=this.minlength&&(c||!i[_])){let P=ce(u,o,f),b="";switch(this.tokenize){case"full":if(3$;N--)if(N-$>=this.minlength){const w=ce(u,o,f,m,$);b=_.substring($,N),this.push_index(i,b,w,e,n)}break}case"reverse":if(2=this.minlength){const N=ce(u,o,f,m,$);this.push_index(i,b,N,e,n)}b=""}case"forward":if(1=this.minlength&&this.push_index(i,b,P,e,n);break}default:if(this.boost&&(P=Math.min(0|P/this.boost(t,_,f),u-1)),this.push_index(i,_,P,e,n),c&&1=this.minlength&&!$[_]){$[_]=1;const K=ce(N+(o/2>N?0:1),o,f,U-1,D-1),Q=this.bidirectional&&_>w;this.push_index(a,Q?w:_,K,e,n,Q?_:w)}}}}}this.fastupdate||(this.register[e]=1)}}return this};function ce(e,t,n,s,o){return n&&1=this.minlength&&!m[b]){if(!this.optimize&&!a&&!this.map[b])return i;P[N++]=b,m[b]=1}e=P,s=e.length}if(!s)return i;t||(t=100);let u,f=this.depth&&1=n)))));b++);if(f)return o?Re(c,n,0):void(e[e.length]=c)}return!t&&c};function Re(e,t,n){return e=e.length===1?e[0]:ba(e),n||e.length>t?e.slice(n,n+t):e}function xe(e,t,n,s){if(n){const o=s&&t>n;e=e[o?t:n],e=e&&e[o?n:t]}else e=e[t];return e}R.prototype.contain=function(e){return!!this.register[e]},R.prototype.update=function(e,t){return this.remove(e).add(e,t)},R.prototype.remove=function(e,t){const n=this.register[e];if(n){if(this.fastupdate)for(let s,o=0;o{if(a.value){for(var B=m.value.search(a.value,{enrich:!0}),H=[],q=0;q!B||!B.length?[]:B.reduce((q,E)=>(q[H(E)]||(q[H(E)]=[]),q[H(E)].push(E),q),{}),K=()=>{setTimeout(()=>{c.value&&c.value.focus()},100),Fe(),o.value=!0};te(async()=>{var E,O;const B=await Vt(()=>import("./virtual_search-data.B6rXHXE7.js"),[]);u.value=B.default.INDEX_DATA,f.value=B.default.PREVIEW_LOOKUP,_.value=B.default.Options,i.value=window.location.origin+me(n.value==="root"?"/":n.value),P.value=((E=_.value)==null?void 0:E.buttonLabel)||P.value,b.value=((O=_.value)==null?void 0:O.placeholder)||b.value;var H=new R(_.value);H.import("reg",u.value.reg),H.import("cfg",u.value.cfg),H.import("map",u.value.map),H.import("ctx",u.value.ctx),m.value=H,s.value.innerHTML=/(Mac|iPhone|iPod|iPad)/i.test(navigator.platform)?"⌘":"Ctrl";const q=G=>{var se;G.key==="k"&&(G.ctrlKey||G.metaKey)&&(G.preventDefault(),K()),G.key==="Escape"&&((se=a.value)==null?void 0:se.length)==0&&o.value&&(o.value=!1)};window.addEventListener("keydown",q)});const Q=V(()=>D(U.value,B=>B.link.split("/").slice(0,-1).join("-"))),ne=V(()=>Object.values(Q.value).flat().map(B=>B.id));function Fe(){o.value=!1,a.value=""}const vt=B=>{var H,q;if(document.getElementsByClassName("search-group")[0]){if(B.key=="ArrowUp"||B.key=="ArrowDown"){const E=ne.value.indexOf($.value);if(B.key=="ArrowUp"){const O=E==0?ne.value.length-1:E-1;$.value=ne.value[O]}if(B.key=="ArrowDown"){const O=E>ne.value.length-2?0:E+1;$.value=ne.value[O]}if(E<5){const O=N.value.getElementsByClassName("VPPluginSearch-search-group")[0];O==null||O.scrollIntoView(!0)}else(H=document.getElementById(ne.value[$.value]))==null||H.scrollIntoView(!0);Ae()}B.key=="Enter"&&w.go(t.site.value.base+((q=N.value.getElementsByClassName("link-focused")[0].getAttribute("href"))==null?void 0:q.replace(i.value,"")))}};return(B,H)=>{const q=Z("ClientOnly");return r(),p("div",za,[y(q,null,{default:v(()=>[(r(),S(wt,{to:"body"},[ze(h("div",{class:"VPPluginSearch-modal-back",onClick:H[2]||(H[2]=E=>o.value=!1),onKeydown:vt},[h("div",{class:"VPPluginSearch-modal",onClick:H[1]||(H[1]=et(()=>{},["stop"])),ref_key:"modal",ref:N},[h("form",ja,[Ua,ze(h("input",{class:"DocSearch-Input","aria-autocomplete":"both","aria-labelledby":"docsearch-label",id:"docsearch-input",autocomplete:"off",autocorrect:"off",autocapitalize:"off",enterkeyhint:"search",spellcheck:"false",autofocus:"true","onUpdate:modelValue":H[0]||(H[0]=E=>a.value=E),placeholder:b.value,maxlength:"64",type:"search",ref_key:"input",ref:c},null,8,qa),[[St,a.value]])]),h("div",Ga,[(r(!0),p(C,null,F(Q.value,(E,O)=>(r(),p("div",{class:"search-group",key:O},[h("span",Ra,M(O?O.toString()[0].toUpperCase()+O.toString().slice(1):"Home"),1),(r(!0),p(C,null,F(E,(G,se)=>(r(),p("a",{href:i.value+G.link,key:G.id,onClick:Fe,onMouseenter:le=>$.value=G.id,class:A({"link-focused":$.value==G.id}),id:se.toString()},[h("div",Ka,[h("span",Wa,M(G.link.includes("#")?"#":"▤"),1),h("div",Ja,[h("h3",null,M(G.title),1),h("p",null,[h("div",{innerHTML:G.preview},null,8,Xa)])]),Ya])],42,xa))),128))]))),128))]),Qa],512)],544),[[Lt,o.value]])]))]),_:1}),h("div",{id:"docsearch",onClick:H[3]||(H[3]=E=>K())},[h("button",Za,[h("span",ei,[ti,h("span",ni,M(P.value),1)]),h("span",si,[h("span",{class:"DocSearch-Button-Key",ref_key:"metaKey",ref:s},"Meta",512),oi])])])])}}}),ii=k({__name:"VPNavBarSocialLinks",setup(e){const{theme:t}=T();return(n,s)=>l(t).socialLinks?(r(),S(De,{key:0,class:"VPNavBarSocialLinks",links:l(t).socialLinks},null,8,["links"])):g("",!0)}}),ri=L(ii,[["__scopeId","data-v-0394ad82"]]),li=["href","rel","target"],ci={key:1},ui={key:2},di=k({__name:"VPNavBarTitle",setup(e){const{site:t,theme:n}=T(),{hasSidebar:s}=Y(),{currentLang:o}=re(),a=V(()=>{var u;return typeof n.value.logoLink=="string"?n.value.logoLink:(u=n.value.logoLink)==null?void 0:u.link}),i=V(()=>{var u;return typeof n.value.logoLink=="string"||(u=n.value.logoLink)==null?void 0:u.rel}),c=V(()=>{var u;return typeof n.value.logoLink=="string"||(u=n.value.logoLink)==null?void 0:u.target});return(u,f)=>(r(),p("div",{class:A(["VPNavBarTitle",{"has-sidebar":l(s)}])},[h("a",{class:"title",href:a.value??l(Ce)(l(o).link),rel:i.value,target:c.value},[d(u.$slots,"nav-bar-title-before",{},void 0,!0),l(n).logo?(r(),S(pe,{key:0,class:"logo",image:l(n).logo},null,8,["image"])):g("",!0),l(n).siteTitle?(r(),p("span",ci,M(l(n).siteTitle),1)):l(n).siteTitle===void 0?(r(),p("span",ui,M(l(t).title),1)):g("",!0),d(u.$slots,"nav-bar-title-after",{},void 0,!0)],8,li)],2))}}),hi=L(di,[["__scopeId","data-v-ab179fa1"]]),pi={class:"items"},vi={class:"title"},fi=k({__name:"VPNavBarTranslations",setup(e){const{theme:t}=T(),{localeLinks:n,currentLang:s}=re({correspondingLink:!0});return(o,a)=>l(n).length&&l(s).label?(r(),S(Oe,{key:0,class:"VPNavBarTranslations",icon:"vpi-languages",label:l(t).langMenuLabel||"Change language"},{default:v(()=>[h("div",pi,[h("p",vi,M(l(s).label),1),(r(!0),p(C,null,F(l(n),i=>(r(),S($e,{key:i.link,item:i},null,8,["item"]))),128))])]),_:1},8,["label"])):g("",!0)}}),mi=L(fi,[["__scopeId","data-v-88af2de4"]]),_i=e=>(z("data-v-ccf7ddec"),e=e(),j(),e),gi={class:"wrapper"},ki={class:"container"},bi={class:"title"},$i={class:"content"},yi={class:"content-body"},Pi=_i(()=>h("div",{class:"divider"},[h("div",{class:"divider-line"})],-1)),Vi=k({__name:"VPNavBar",props:{isScreenOpen:{type:Boolean}},emits:["toggle-screen"],setup(e){const{y:t}=Ze(),{hasSidebar:n}=Y(),{frontmatter:s}=T(),o=I({});return Je(()=>{o.value={"has-sidebar":n.value,home:s.value.layout==="home",top:t.value===0}}),(a,i)=>(r(),p("div",{class:A(["VPNavBar",o.value])},[h("div",gi,[h("div",ki,[h("div",bi,[y(hi,null,{"nav-bar-title-before":v(()=>[d(a.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":v(()=>[d(a.$slots,"nav-bar-title-after",{},void 0,!0)]),_:3})]),h("div",$i,[h("div",yi,[d(a.$slots,"nav-bar-content-before",{},void 0,!0),y(ai,{class:"search"}),y(_a,{class:"menu"}),y(mi,{class:"translations"}),y(bo,{class:"appearance"}),y(ri,{class:"social-links"}),y(na,{class:"extra"}),d(a.$slots,"nav-bar-content-after",{},void 0,!0),y(la,{class:"hamburger",active:a.isScreenOpen,onClick:i[0]||(i[0]=c=>a.$emit("toggle-screen"))},null,8,["active"])])])])]),Pi],2))}}),Li=L(Vi,[["__scopeId","data-v-ccf7ddec"]]),Si={key:0,class:"VPNavScreenAppearance"},wi={class:"text"},Ii=k({__name:"VPNavScreenAppearance",setup(e){const{site:t,theme:n}=T();return(s,o)=>l(t).appearance&&l(t).appearance!=="force-dark"?(r(),p("div",Si,[h("p",wi,M(l(n).darkModeSwitchLabel||"Appearance"),1),y(Be)])):g("",!0)}}),Ti=L(Ii,[["__scopeId","data-v-2d7af913"]]),Ni=k({__name:"VPNavScreenMenuLink",props:{item:{}},setup(e){const t=ke("close-screen");return(n,s)=>(r(),S(W,{class:"VPNavScreenMenuLink",href:n.item.link,target:n.item.target,rel:n.item.rel,onClick:l(t),innerHTML:n.item.text},null,8,["href","target","rel","onClick","innerHTML"]))}}),Mi=L(Ni,[["__scopeId","data-v-7f31e1f6"]]),Ai=k({__name:"VPNavScreenMenuGroupLink",props:{item:{}},setup(e){const t=ke("close-screen");return(n,s)=>(r(),S(W,{class:"VPNavScreenMenuGroupLink",href:n.item.link,target:n.item.target,rel:n.item.rel,onClick:l(t)},{default:v(()=>[J(M(n.item.text),1)]),_:1},8,["href","target","rel","onClick"]))}}),ut=L(Ai,[["__scopeId","data-v-19976ae1"]]),Ci={class:"VPNavScreenMenuGroupSection"},Hi={key:0,class:"title"},Bi=k({__name:"VPNavScreenMenuGroupSection",props:{text:{},items:{}},setup(e){return(t,n)=>(r(),p("div",Ci,[t.text?(r(),p("p",Hi,M(t.text),1)):g("",!0),(r(!0),p(C,null,F(t.items,s=>(r(),S(ut,{key:s.text,item:s},null,8,["item"]))),128))]))}}),Ei=L(Bi,[["__scopeId","data-v-8133b170"]]),Oi=e=>(z("data-v-ff6087d4"),e=e(),j(),e),Di=["aria-controls","aria-expanded"],Fi=["innerHTML"],zi=Oi(()=>h("span",{class:"vpi-plus button-icon"},null,-1)),ji=["id"],Ui={key:1,class:"group"},qi=k({__name:"VPNavScreenMenuGroup",props:{text:{},items:{}},setup(e){const t=e,n=I(!1),s=V(()=>`NavScreenGroup-${t.text.replace(" ","-").toLowerCase()}`);function o(){n.value=!n.value}return(a,i)=>(r(),p("div",{class:A(["VPNavScreenMenuGroup",{open:n.value}])},[h("button",{class:"button","aria-controls":s.value,"aria-expanded":n.value,onClick:o},[h("span",{class:"button-text",innerHTML:a.text},null,8,Fi),zi],8,Di),h("div",{id:s.value,class:"items"},[(r(!0),p(C,null,F(a.items,c=>(r(),p(C,{key:c.text},["link"in c?(r(),p("div",{key:c.text,class:"item"},[y(ut,{item:c},null,8,["item"])])):(r(),p("div",Ui,[y(Ei,{text:c.text,items:c.items},null,8,["text","items"])]))],64))),128))],8,ji)],2))}}),Gi=L(qi,[["__scopeId","data-v-ff6087d4"]]),Ri={key:0,class:"VPNavScreenMenu"},xi=k({__name:"VPNavScreenMenu",setup(e){const{theme:t}=T();return(n,s)=>l(t).nav?(r(),p("nav",Ri,[(r(!0),p(C,null,F(l(t).nav,o=>(r(),p(C,{key:o.text},["link"in o?(r(),S(Mi,{key:0,item:o},null,8,["item"])):(r(),S(Gi,{key:1,text:o.text||"",items:o.items},null,8,["text","items"]))],64))),128))])):g("",!0)}}),Ki=k({__name:"VPNavScreenSocialLinks",setup(e){const{theme:t}=T();return(n,s)=>l(t).socialLinks?(r(),S(De,{key:0,class:"VPNavScreenSocialLinks",links:l(t).socialLinks},null,8,["links"])):g("",!0)}}),dt=e=>(z("data-v-858fe1a4"),e=e(),j(),e),Wi=dt(()=>h("span",{class:"vpi-languages icon lang"},null,-1)),Ji=dt(()=>h("span",{class:"vpi-chevron-down icon chevron"},null,-1)),Xi={class:"list"},Yi=k({__name:"VPNavScreenTranslations",setup(e){const{localeLinks:t,currentLang:n}=re({correspondingLink:!0}),s=I(!1);function o(){s.value=!s.value}return(a,i)=>l(t).length&&l(n).label?(r(),p("div",{key:0,class:A(["VPNavScreenTranslations",{open:s.value}])},[h("button",{class:"title",onClick:o},[Wi,J(" "+M(l(n).label)+" ",1),Ji]),h("ul",Xi,[(r(!0),p(C,null,F(l(t),c=>(r(),p("li",{key:c.link,class:"item"},[y(W,{class:"link",href:c.link},{default:v(()=>[J(M(c.text),1)]),_:2},1032,["href"])]))),128))])],2)):g("",!0)}}),Qi=L(Yi,[["__scopeId","data-v-858fe1a4"]]),Zi={class:"container"},er=k({__name:"VPNavScreen",props:{open:{type:Boolean}},setup(e){const t=I(null),n=tt(be?document.body:null);return(s,o)=>(r(),S(Ne,{name:"fade",onEnter:o[0]||(o[0]=a=>n.value=!0),onAfterLeave:o[1]||(o[1]=a=>n.value=!1)},{default:v(()=>[s.open?(r(),p("div",{key:0,class:"VPNavScreen",ref_key:"screen",ref:t,id:"VPNavScreen"},[h("div",Zi,[d(s.$slots,"nav-screen-content-before",{},void 0,!0),y(xi,{class:"menu"}),y(Qi,{class:"translations"}),y(Ti,{class:"appearance"}),y(Ki,{class:"social-links"}),d(s.$slots,"nav-screen-content-after",{},void 0,!0)])],512)):g("",!0)]),_:3}))}}),tr=L(er,[["__scopeId","data-v-cc5739dd"]]),nr={key:0,class:"VPNav"},sr=k({__name:"VPNav",setup(e){const{isScreenOpen:t,closeScreen:n,toggleScreen:s}=ro(),{frontmatter:o}=T(),a=V(()=>o.value.navbar!==!1);return nt("close-screen",n),_e(()=>{be&&document.documentElement.classList.toggle("hide-nav",!a.value)}),(i,c)=>a.value?(r(),p("header",nr,[y(Li,{"is-screen-open":l(t),onToggleScreen:l(s)},{"nav-bar-title-before":v(()=>[d(i.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":v(()=>[d(i.$slots,"nav-bar-title-after",{},void 0,!0)]),"nav-bar-content-before":v(()=>[d(i.$slots,"nav-bar-content-before",{},void 0,!0)]),"nav-bar-content-after":v(()=>[d(i.$slots,"nav-bar-content-after",{},void 0,!0)]),_:3},8,["is-screen-open","onToggleScreen"]),y(tr,{open:l(t)},{"nav-screen-content-before":v(()=>[d(i.$slots,"nav-screen-content-before",{},void 0,!0)]),"nav-screen-content-after":v(()=>[d(i.$slots,"nav-screen-content-after",{},void 0,!0)]),_:3},8,["open"])])):g("",!0)}}),or=L(sr,[["__scopeId","data-v-ae24b3ad"]]),ht=e=>(z("data-v-b8d55f3b"),e=e(),j(),e),ar=["role","tabindex"],ir=ht(()=>h("div",{class:"indicator"},null,-1)),rr=["onKeydown"],lr=ht(()=>h("span",{class:"vpi-chevron-right caret-icon"},null,-1)),cr=[lr],ur={key:1,class:"items"},dr=k({__name:"VPSidebarItem",props:{item:{},depth:{}},setup(e){const t=e,{collapsed:n,collapsible:s,isLink:o,isActiveLink:a,hasActiveLink:i,hasChildren:c,toggle:u}=Yt(V(()=>t.item)),f=V(()=>c.value?"section":"div"),_=V(()=>o.value?"a":"div"),m=V(()=>c.value?t.depth+2===7?"p":`h${t.depth+2}`:"p"),P=V(()=>o.value?void 0:"button"),b=V(()=>[[`level-${t.depth}`],{collapsible:s.value},{collapsed:n.value},{"is-link":o.value},{"is-active":a.value},{"has-active":i.value}]);function $(w){"key"in w&&w.key!=="Enter"||!t.item.link&&u()}function N(){t.item.link&&u()}return(w,U)=>{const D=Z("VPSidebarItem",!0);return r(),S(oe(f.value),{class:A(["VPSidebarItem",b.value])},{default:v(()=>[w.item.text?(r(),p("div",ue({key:0,class:"item",role:P.value},Tt(w.item.items?{click:$,keydown:$}:{},!0),{tabindex:w.item.items&&0}),[ir,w.item.link?(r(),S(W,{key:0,tag:_.value,class:"link",href:w.item.link,rel:w.item.rel,target:w.item.target},{default:v(()=>[(r(),S(oe(m.value),{class:"text",innerHTML:w.item.text},null,8,["innerHTML"]))]),_:1},8,["tag","href","rel","target"])):(r(),S(oe(m.value),{key:1,class:"text",innerHTML:w.item.text},null,8,["innerHTML"])),w.item.collapsed!=null&&w.item.items&&w.item.items.length?(r(),p("div",{key:2,class:"caret",role:"button","aria-label":"toggle section",onClick:N,onKeydown:It(N,["enter"]),tabindex:"0"},cr,40,rr)):g("",!0)],16,ar)):g("",!0),w.item.items&&w.item.items.length?(r(),p("div",ur,[w.depth<5?(r(!0),p(C,{key:0},F(w.item.items,K=>(r(),S(D,{key:K.text,item:K,depth:w.depth+1},null,8,["item","depth"]))),128)):g("",!0)])):g("",!0)]),_:1},8,["class"])}}}),hr=L(dr,[["__scopeId","data-v-b8d55f3b"]]),pt=e=>(z("data-v-575e6a36"),e=e(),j(),e),pr=pt(()=>h("div",{class:"curtain"},null,-1)),vr={class:"nav",id:"VPSidebarNav","aria-labelledby":"sidebar-aria-label",tabindex:"-1"},fr=pt(()=>h("span",{class:"visually-hidden",id:"sidebar-aria-label"}," Sidebar Navigation ",-1)),mr=k({__name:"VPSidebar",props:{open:{type:Boolean}},setup(e){const t=e,{sidebarGroups:n,hasSidebar:s}=Y(),o=I(null),a=tt(be?document.body:null);return X([t,o],()=>{var i;t.open?(a.value=!0,(i=o.value)==null||i.focus()):a.value=!1},{immediate:!0,flush:"post"}),(i,c)=>l(s)?(r(),p("aside",{key:0,class:A(["VPSidebar",{open:i.open}]),ref_key:"navEl",ref:o,onClick:c[0]||(c[0]=et(()=>{},["stop"]))},[pr,h("nav",vr,[fr,d(i.$slots,"sidebar-nav-before",{},void 0,!0),(r(!0),p(C,null,F(l(n),u=>(r(),p("div",{key:u.text,class:"group"},[y(hr,{item:u,depth:0},null,8,["item"])]))),128)),d(i.$slots,"sidebar-nav-after",{},void 0,!0)])],2)):g("",!0)}}),_r=L(mr,[["__scopeId","data-v-575e6a36"]]),gr=k({__name:"VPSkipLink",setup(e){const t=ie(),n=I();X(()=>t.path,()=>n.value.focus());function s({target:o}){const a=document.getElementById(decodeURIComponent(o.hash).slice(1));if(a){const i=()=>{a.removeAttribute("tabindex"),a.removeEventListener("blur",i)};a.setAttribute("tabindex","-1"),a.addEventListener("blur",i),a.focus(),window.scrollTo(0,0)}}return(o,a)=>(r(),p(C,null,[h("span",{ref_key:"backToTop",ref:n,tabindex:"-1"},null,512),h("a",{href:"#VPContent",class:"VPSkipLink visually-hidden",onClick:s}," Skip to content ")],64))}}),kr=L(gr,[["__scopeId","data-v-0f60ec36"]]),br=k({__name:"Layout",setup(e){const{isOpen:t,open:n,close:s}=Y(),o=ie();X(()=>o.path,s),Xt(t,s);const{frontmatter:a}=T(),i=Nt(),c=V(()=>!!i["home-hero-image"]);return nt("hero-image-slot-exists",c),(u,f)=>{const _=Z("Content");return l(a).layout!==!1?(r(),p("div",{key:0,class:A(["Layout",l(a).pageClass])},[d(u.$slots,"layout-top",{},void 0,!0),y(kr),y(Bt,{class:"backdrop",show:l(t),onClick:l(s)},null,8,["show","onClick"]),y(or,null,{"nav-bar-title-before":v(()=>[d(u.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":v(()=>[d(u.$slots,"nav-bar-title-after",{},void 0,!0)]),"nav-bar-content-before":v(()=>[d(u.$slots,"nav-bar-content-before",{},void 0,!0)]),"nav-bar-content-after":v(()=>[d(u.$slots,"nav-bar-content-after",{},void 0,!0)]),"nav-screen-content-before":v(()=>[d(u.$slots,"nav-screen-content-before",{},void 0,!0)]),"nav-screen-content-after":v(()=>[d(u.$slots,"nav-screen-content-after",{},void 0,!0)]),_:3}),y(io,{open:l(t),onOpenMenu:l(n)},null,8,["open","onOpenMenu"]),y(_r,{open:l(t)},{"sidebar-nav-before":v(()=>[d(u.$slots,"sidebar-nav-before",{},void 0,!0)]),"sidebar-nav-after":v(()=>[d(u.$slots,"sidebar-nav-after",{},void 0,!0)]),_:3},8,["open"]),y(zs,null,{"page-top":v(()=>[d(u.$slots,"page-top",{},void 0,!0)]),"page-bottom":v(()=>[d(u.$slots,"page-bottom",{},void 0,!0)]),"not-found":v(()=>[d(u.$slots,"not-found",{},void 0,!0)]),"home-hero-before":v(()=>[d(u.$slots,"home-hero-before",{},void 0,!0)]),"home-hero-info-before":v(()=>[d(u.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":v(()=>[d(u.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":v(()=>[d(u.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":v(()=>[d(u.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":v(()=>[d(u.$slots,"home-hero-image",{},void 0,!0)]),"home-hero-after":v(()=>[d(u.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":v(()=>[d(u.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":v(()=>[d(u.$slots,"home-features-after",{},void 0,!0)]),"doc-footer-before":v(()=>[d(u.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":v(()=>[d(u.$slots,"doc-before",{},void 0,!0)]),"doc-after":v(()=>[d(u.$slots,"doc-after",{},void 0,!0)]),"doc-top":v(()=>[d(u.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":v(()=>[d(u.$slots,"doc-bottom",{},void 0,!0)]),"aside-top":v(()=>[d(u.$slots,"aside-top",{},void 0,!0)]),"aside-bottom":v(()=>[d(u.$slots,"aside-bottom",{},void 0,!0)]),"aside-outline-before":v(()=>[d(u.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":v(()=>[d(u.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":v(()=>[d(u.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":v(()=>[d(u.$slots,"aside-ads-after",{},void 0,!0)]),_:3}),y(Rs),d(u.$slots,"layout-bottom",{},void 0,!0)],2)):(r(),S(_,{key:1}))}}}),$r=L(br,[["__scopeId","data-v-5d98c3a5"]]),Ke={Layout:$r,enhanceApp:({app:e})=>{e.component("Badge",At)}},yr=k({__name:"HighlightTargetedHeading",setup(e){function t(){if(!window||!window.location||!window.location.hash)return;const s=decodeURIComponent(window.location.hash);if(!s)return;let o;try{o=document.querySelector(s)}catch(a){console.error(a);return}o&&(o.classList.contains("VPNolebaseHighlightTargetedHeading")||o.classList.add("VPNolebaseHighlightTargetedHeading"),o.classList.remove("VPNolebaseHighlightTargetedHeadingAnimated"),setTimeout(()=>{o&&o.classList.add("VPNolebaseHighlightTargetedHeadingAnimated")},10))}const n=ie();return te(t),X(n,async()=>{await Ae(),t()}),Mt("hashchange",t),(s,o)=>d(s.$slots,"default")}}),Vr={...Ke,Layout:()=>je(Ke.Layout,null,{"layout-top":()=>[je(yr)]})};export{Vr as R}; +import{d as k,o as r,c as p,r as d,n as A,a as J,t as M,b as S,w as v,e as g,T as Ne,_ as L,u as We,i as mt,f as _t,g as me,h as V,j as h,k as l,p as z,l as j,m as ee,q as Le,s as I,v as X,x as _e,y as te,z as Me,A as Je,B as gt,C as kt,D as Z,F as C,E as F,G as Xe,H as ge,I as y,J as oe,K as Ye,L as ie,M as ue,N as ke,O as bt,P as Qe,Q as $t,R as Ae,S as Ze,U as be,V as yt,W as Pt,X as Vt,Y as ze,Z as Lt,$ as et,a0 as St,a1 as wt,a2 as tt,a3 as nt,a4 as It,a5 as Tt,a6 as Nt,a7 as Mt,a8 as je}from"./framework.D8PMdl4T.js";const At=k({__name:"VPBadge",props:{text:{},type:{default:"tip"}},setup(e){return(t,n)=>(r(),p("span",{class:A(["VPBadge",t.type])},[d(t.$slots,"default",{},()=>[J(M(t.text),1)])],2))}}),Ct={key:0,class:"VPBackdrop"},Ht=k({__name:"VPBackdrop",props:{show:{type:Boolean}},setup(e){return(t,n)=>(r(),S(Ne,{name:"fade"},{default:v(()=>[t.show?(r(),p("div",Ct)):g("",!0)]),_:1}))}}),Bt=L(Ht,[["__scopeId","data-v-c79a1216"]]),T=We;function Et(e,t){let n,s=!1;return()=>{n&&clearTimeout(n),s?n=setTimeout(e,t):(e(),(s=!0)&&setTimeout(()=>s=!1,t))}}function Se(e){return/^\//.test(e)?e:`/${e}`}function Ce(e){const{pathname:t,search:n,hash:s,protocol:o}=new URL(e,"http://a.com");if(mt(e)||e.startsWith("#")||!o.startsWith("http")||!_t(t))return e;const{site:a}=T(),i=t.endsWith("/")||t.endsWith(".html")?e:e.replace(/(?:(^\.+)\/)?.*$/,`$1${t.replace(/(\.md)?$/,a.value.cleanUrls?"":".html")}${n}${s}`);return me(i)}function re({correspondingLink:e=!1}={}){const{site:t,localeIndex:n,page:s,theme:o,hash:a}=T(),i=V(()=>{var u,f;return{label:(u=t.value.locales[n.value])==null?void 0:u.label,link:((f=t.value.locales[n.value])==null?void 0:f.link)||(n.value==="root"?"/":`/${n.value}/`)}});return{localeLinks:V(()=>Object.entries(t.value.locales).flatMap(([u,f])=>i.value.label===f.label?[]:{text:f.label,link:Ot(f.link||(u==="root"?"/":`/${u}/`),o.value.i18nRouting!==!1&&e,s.value.relativePath.slice(i.value.link.length-1),!t.value.cleanUrls)+a.value})),currentLang:i}}function Ot(e,t,n,s){return t?e.replace(/\/$/,"")+Se(n.replace(/(^|\/)index\.md$/,"$1").replace(/\.md$/,s?".html":"")):e}const Dt=e=>(z("data-v-d6be1790"),e=e(),j(),e),Ft={class:"NotFound"},zt={class:"code"},jt={class:"title"},Ut=Dt(()=>h("div",{class:"divider"},null,-1)),qt={class:"quote"},Gt={class:"action"},Rt=["href","aria-label"],xt=k({__name:"NotFound",setup(e){const{theme:t}=T(),{currentLang:n}=re();return(s,o)=>{var a,i,c,u,f;return r(),p("div",Ft,[h("p",zt,M(((a=l(t).notFound)==null?void 0:a.code)??"404"),1),h("h1",jt,M(((i=l(t).notFound)==null?void 0:i.title)??"PAGE NOT FOUND"),1),Ut,h("blockquote",qt,M(((c=l(t).notFound)==null?void 0:c.quote)??"But if you don't change your direction, and if you keep looking, you may end up where you are heading."),1),h("div",Gt,[h("a",{class:"link",href:l(me)(l(n).link),"aria-label":((u=l(t).notFound)==null?void 0:u.linkLabel)??"go to home"},M(((f=l(t).notFound)==null?void 0:f.linkText)??"Take me home"),9,Rt)])])}}}),Kt=L(xt,[["__scopeId","data-v-d6be1790"]]);function st(e,t){if(Array.isArray(e))return de(e);if(e==null)return[];t=Se(t);const n=Object.keys(e).sort((o,a)=>a.split("/").length-o.split("/").length).find(o=>t.startsWith(Se(o))),s=n?e[n]:[];return Array.isArray(s)?de(s):de(s.items,s.base)}function Wt(e){const t=[];let n=0;for(const s in e){const o=e[s];if(o.items){n=t.push(o);continue}t[n]||t.push({items:[]}),t[n].items.push(o)}return t}function Jt(e){const t=[];function n(s){for(const o of s)o.text&&o.link&&t.push({text:o.text,link:o.link,docFooterText:o.docFooterText}),o.items&&n(o.items)}return n(e),t}function we(e,t){return Array.isArray(t)?t.some(n=>we(e,n)):ee(e,t.link)?!0:t.items?we(e,t.items):!1}function de(e,t){return[...e].map(n=>{const s={...n},o=s.base||t;return o&&s.link&&(s.link=o+s.link),s.items&&(s.items=de(s.items,o)),s})}function Y(){const{frontmatter:e,page:t,theme:n}=T(),s=Le("(min-width: 960px)"),o=I(!1),a=V(()=>{const N=n.value.sidebar,w=t.value.relativePath;return N?st(N,w):[]}),i=I(a.value);X(a,(N,w)=>{JSON.stringify(N)!==JSON.stringify(w)&&(i.value=a.value)});const c=V(()=>e.value.sidebar!==!1&&i.value.length>0&&e.value.layout!=="home"),u=V(()=>f?e.value.aside==null?n.value.aside==="left":e.value.aside==="left":!1),f=V(()=>e.value.layout==="home"?!1:e.value.aside!=null?!!e.value.aside:n.value.aside!==!1),_=V(()=>c.value&&s.value),m=V(()=>c.value?Wt(i.value):[]);function P(){o.value=!0}function b(){o.value=!1}function $(){o.value?b():P()}return{isOpen:o,sidebar:i,sidebarGroups:m,hasSidebar:c,hasAside:f,leftAside:u,isSidebarEnabled:_,open:P,close:b,toggle:$}}function Xt(e,t){let n;_e(()=>{n=e.value?document.activeElement:void 0}),te(()=>{window.addEventListener("keyup",s)}),Me(()=>{window.removeEventListener("keyup",s)});function s(o){o.key==="Escape"&&e.value&&(t(),n==null||n.focus())}}function Yt(e){const{page:t,hash:n}=T(),s=I(!1),o=V(()=>e.value.collapsed!=null),a=V(()=>!!e.value.link),i=I(!1),c=()=>{i.value=ee(t.value.relativePath,e.value.link)};X([t,e,n],c),te(c);const u=V(()=>i.value?!0:e.value.items?we(t.value.relativePath,e.value.items):!1),f=V(()=>!!(e.value.items&&e.value.items.length));_e(()=>{s.value=!!(o.value&&e.value.collapsed)}),Je(()=>{(i.value||u.value)&&(s.value=!1)});function _(){o.value&&(s.value=!s.value)}return{collapsed:s,collapsible:o,isLink:a,isActiveLink:i,hasActiveLink:u,hasChildren:f,toggle:_}}function Qt(){const{hasSidebar:e}=Y(),t=Le("(min-width: 960px)"),n=Le("(min-width: 1280px)");return{isAsideEnabled:V(()=>!n.value&&!t.value?!1:e.value?n.value:t.value)}}const Ie=[];function ot(e){return typeof e.outline=="object"&&!Array.isArray(e.outline)&&e.outline.label||e.outlineTitle||"On this page"}function He(e){const t=[...document.querySelectorAll(".VPDoc :where(h1,h2,h3,h4,h5,h6)")].filter(n=>n.id&&n.hasChildNodes()).map(n=>{const s=Number(n.tagName[1]);return{element:n,title:Zt(n),link:"#"+n.id,level:s}});return en(t,e)}function Zt(e){let t="";for(const n of e.childNodes)if(n.nodeType===1){if(n.classList.contains("VPBadge")||n.classList.contains("header-anchor")||n.classList.contains("ignore-header"))continue;t+=n.textContent}else n.nodeType===3&&(t+=n.textContent);return t.trim()}function en(e,t){if(t===!1)return[];const n=(typeof t=="object"&&!Array.isArray(t)?t.level:t)||2,[s,o]=typeof n=="number"?[n,n]:n==="deep"?[2,6]:n;e=e.filter(i=>i.level>=s&&i.level<=o),Ie.length=0;for(const{element:i,link:c}of e)Ie.push({element:i,link:c});const a=[];e:for(let i=0;i=0;u--){const f=e[u];if(f.level{requestAnimationFrame(a),window.addEventListener("scroll",s)}),gt(()=>{i(location.hash)}),Me(()=>{window.removeEventListener("scroll",s)});function a(){if(!n.value)return;const c=window.scrollY,u=window.innerHeight,f=document.body.offsetHeight,_=Math.abs(c+u-f)<1,m=Ie.map(({element:b,link:$})=>({link:$,top:nn(b)})).filter(({top:b})=>!Number.isNaN(b)).sort((b,$)=>b.top-$.top);if(!m.length){i(null);return}if(c<1){i(null);return}if(_){i(m[m.length-1].link);return}let P=null;for(const{link:b,top:$}of m){if($>c+kt()+4)break;P=b}i(P)}function i(c){o&&o.classList.remove("active"),c==null?o=null:o=e.value.querySelector(`a[href="${decodeURIComponent(c)}"]`);const u=o;u?(u.classList.add("active"),t.value.style.top=u.offsetTop+39+"px",t.value.style.opacity="1"):(t.value.style.top="33px",t.value.style.opacity="0")}}function nn(e){let t=0;for(;e!==document.body;){if(e===null)return NaN;t+=e.offsetTop,e=e.offsetParent}return t}const sn=["href","title"],on=k({__name:"VPDocOutlineItem",props:{headers:{},root:{type:Boolean}},setup(e){function t({target:n}){const s=n.href.split("#")[1],o=document.getElementById(decodeURIComponent(s));o==null||o.focus({preventScroll:!0})}return(n,s)=>{const o=Z("VPDocOutlineItem",!0);return r(),p("ul",{class:A(["VPDocOutlineItem",n.root?"root":"nested"])},[(r(!0),p(C,null,F(n.headers,({children:a,link:i,title:c})=>(r(),p("li",null,[h("a",{class:"outline-link",href:i,onClick:t,title:c},M(c),9,sn),a!=null&&a.length?(r(),S(o,{key:0,headers:a},null,8,["headers"])):g("",!0)]))),256))],2)}}}),at=L(on,[["__scopeId","data-v-b933a997"]]),an={class:"content"},rn={"aria-level":"2",class:"outline-title",id:"doc-outline-aria-label",role:"heading"},ln=k({__name:"VPDocAsideOutline",setup(e){const{frontmatter:t,theme:n}=T(),s=Xe([]);ge(()=>{s.value=He(t.value.outline??n.value.outline)});const o=I(),a=I();return tn(o,a),(i,c)=>(r(),p("nav",{"aria-labelledby":"doc-outline-aria-label",class:A(["VPDocAsideOutline",{"has-outline":s.value.length>0}]),ref_key:"container",ref:o},[h("div",an,[h("div",{class:"outline-marker",ref_key:"marker",ref:a},null,512),h("div",rn,M(l(ot)(l(n))),1),y(at,{headers:s.value,root:!0},null,8,["headers"])])],2))}}),cn=L(ln,[["__scopeId","data-v-a5bbad30"]]),un={class:"VPDocAsideCarbonAds"},dn=k({__name:"VPDocAsideCarbonAds",props:{carbonAds:{}},setup(e){const t=()=>null;return(n,s)=>(r(),p("div",un,[y(l(t),{"carbon-ads":n.carbonAds},null,8,["carbon-ads"])]))}}),hn=e=>(z("data-v-3f215769"),e=e(),j(),e),pn={class:"VPDocAside"},vn=hn(()=>h("div",{class:"spacer"},null,-1)),fn=k({__name:"VPDocAside",setup(e){const{theme:t}=T();return(n,s)=>(r(),p("div",pn,[d(n.$slots,"aside-top",{},void 0,!0),d(n.$slots,"aside-outline-before",{},void 0,!0),y(cn),d(n.$slots,"aside-outline-after",{},void 0,!0),vn,d(n.$slots,"aside-ads-before",{},void 0,!0),l(t).carbonAds?(r(),S(dn,{key:0,"carbon-ads":l(t).carbonAds},null,8,["carbon-ads"])):g("",!0),d(n.$slots,"aside-ads-after",{},void 0,!0),d(n.$slots,"aside-bottom",{},void 0,!0)]))}}),mn=L(fn,[["__scopeId","data-v-3f215769"]]);function _n(){const{theme:e,page:t}=T();return V(()=>{const{text:n="Edit this page",pattern:s=""}=e.value.editLink||{};let o;return typeof s=="function"?o=s(t.value):o=s.replace(/:path/g,t.value.filePath),{url:o,text:n}})}function gn(){const{page:e,theme:t,frontmatter:n}=T();return V(()=>{var f,_,m,P,b,$,N,w;const s=st(t.value.sidebar,e.value.relativePath),o=Jt(s),a=kn(o,U=>U.link.replace(/[?#].*$/,"")),i=a.findIndex(U=>ee(e.value.relativePath,U.link)),c=((f=t.value.docFooter)==null?void 0:f.prev)===!1&&!n.value.prev||n.value.prev===!1,u=((_=t.value.docFooter)==null?void 0:_.next)===!1&&!n.value.next||n.value.next===!1;return{prev:c?void 0:{text:(typeof n.value.prev=="string"?n.value.prev:typeof n.value.prev=="object"?n.value.prev.text:void 0)??((m=a[i-1])==null?void 0:m.docFooterText)??((P=a[i-1])==null?void 0:P.text),link:(typeof n.value.prev=="object"?n.value.prev.link:void 0)??((b=a[i-1])==null?void 0:b.link)},next:u?void 0:{text:(typeof n.value.next=="string"?n.value.next:typeof n.value.next=="object"?n.value.next.text:void 0)??(($=a[i+1])==null?void 0:$.docFooterText)??((N=a[i+1])==null?void 0:N.text),link:(typeof n.value.next=="object"?n.value.next.link:void 0)??((w=a[i+1])==null?void 0:w.link)}}})}function kn(e,t){const n=new Set;return e.filter(s=>{const o=t(s);return n.has(o)?!1:n.add(o)})}const W=k({__name:"VPLink",props:{tag:{},href:{},noIcon:{type:Boolean},target:{},rel:{}},setup(e){const t=e,n=V(()=>t.tag??(t.href?"a":"span")),s=V(()=>t.href&&Ye.test(t.href)||t.target==="_blank");return(o,a)=>(r(),S(oe(n.value),{class:A(["VPLink",{link:o.href,"vp-external-link-icon":s.value,"no-icon":o.noIcon}]),href:o.href?l(Ce)(o.href):void 0,target:o.target??(s.value?"_blank":void 0),rel:o.rel??(s.value?"noreferrer":void 0)},{default:v(()=>[d(o.$slots,"default")]),_:3},8,["class","href","target","rel"]))}}),bn={class:"VPLastUpdated"},$n=["datetime"],yn=k({__name:"VPDocFooterLastUpdated",setup(e){const{theme:t,page:n,frontmatter:s,lang:o}=T(),a=V(()=>new Date(s.value.lastUpdated??n.value.lastUpdated)),i=V(()=>a.value.toISOString()),c=I("");return te(()=>{_e(()=>{var u,f,_;c.value=new Intl.DateTimeFormat((f=(u=t.value.lastUpdated)==null?void 0:u.formatOptions)!=null&&f.forceLocale?o.value:void 0,((_=t.value.lastUpdated)==null?void 0:_.formatOptions)??{dateStyle:"short",timeStyle:"short"}).format(a.value)})}),(u,f)=>{var _;return r(),p("p",bn,[J(M(((_=l(t).lastUpdated)==null?void 0:_.text)||l(t).lastUpdatedText||"Last updated")+": ",1),h("time",{datetime:i.value},M(c.value),9,$n)])}}}),Pn=L(yn,[["__scopeId","data-v-7e05ebdb"]]),it=e=>(z("data-v-d4a0bba5"),e=e(),j(),e),Vn={key:0,class:"VPDocFooter"},Ln={key:0,class:"edit-info"},Sn={key:0,class:"edit-link"},wn=it(()=>h("span",{class:"vpi-square-pen edit-link-icon"},null,-1)),In={key:1,class:"last-updated"},Tn={key:1,class:"prev-next","aria-labelledby":"doc-footer-aria-label"},Nn=it(()=>h("span",{class:"visually-hidden",id:"doc-footer-aria-label"},"Pager",-1)),Mn={class:"pager"},An=["innerHTML"],Cn=["innerHTML"],Hn={class:"pager"},Bn=["innerHTML"],En=["innerHTML"],On=k({__name:"VPDocFooter",setup(e){const{theme:t,page:n,frontmatter:s}=T(),o=_n(),a=gn(),i=V(()=>t.value.editLink&&s.value.editLink!==!1),c=V(()=>n.value.lastUpdated&&s.value.lastUpdated!==!1),u=V(()=>i.value||c.value||a.value.prev||a.value.next);return(f,_)=>{var m,P,b,$;return u.value?(r(),p("footer",Vn,[d(f.$slots,"doc-footer-before",{},void 0,!0),i.value||c.value?(r(),p("div",Ln,[i.value?(r(),p("div",Sn,[y(W,{class:"edit-link-button",href:l(o).url,"no-icon":!0},{default:v(()=>[wn,J(" "+M(l(o).text),1)]),_:1},8,["href"])])):g("",!0),c.value?(r(),p("div",In,[y(Pn)])):g("",!0)])):g("",!0),(m=l(a).prev)!=null&&m.link||(P=l(a).next)!=null&&P.link?(r(),p("nav",Tn,[Nn,h("div",Mn,[(b=l(a).prev)!=null&&b.link?(r(),S(W,{key:0,class:"pager-link prev",href:l(a).prev.link},{default:v(()=>{var N;return[h("span",{class:"desc",innerHTML:((N=l(t).docFooter)==null?void 0:N.prev)||"Previous page"},null,8,An),h("span",{class:"title",innerHTML:l(a).prev.text},null,8,Cn)]}),_:1},8,["href"])):g("",!0)]),h("div",Hn,[($=l(a).next)!=null&&$.link?(r(),S(W,{key:0,class:"pager-link next",href:l(a).next.link},{default:v(()=>{var N;return[h("span",{class:"desc",innerHTML:((N=l(t).docFooter)==null?void 0:N.next)||"Next page"},null,8,Bn),h("span",{class:"title",innerHTML:l(a).next.text},null,8,En)]}),_:1},8,["href"])):g("",!0)])])):g("",!0)])):g("",!0)}}}),Dn=L(On,[["__scopeId","data-v-d4a0bba5"]]),Fn=e=>(z("data-v-39a288b8"),e=e(),j(),e),zn={class:"container"},jn=Fn(()=>h("div",{class:"aside-curtain"},null,-1)),Un={class:"aside-container"},qn={class:"aside-content"},Gn={class:"content"},Rn={class:"content-container"},xn={class:"main"},Kn=k({__name:"VPDoc",setup(e){const{theme:t}=T(),n=ie(),{hasSidebar:s,hasAside:o,leftAside:a}=Y(),i=V(()=>n.path.replace(/[./]+/g,"_").replace(/_html$/,""));return(c,u)=>{const f=Z("Content");return r(),p("div",{class:A(["VPDoc",{"has-sidebar":l(s),"has-aside":l(o)}])},[d(c.$slots,"doc-top",{},void 0,!0),h("div",zn,[l(o)?(r(),p("div",{key:0,class:A(["aside",{"left-aside":l(a)}])},[jn,h("div",Un,[h("div",qn,[y(mn,null,{"aside-top":v(()=>[d(c.$slots,"aside-top",{},void 0,!0)]),"aside-bottom":v(()=>[d(c.$slots,"aside-bottom",{},void 0,!0)]),"aside-outline-before":v(()=>[d(c.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":v(()=>[d(c.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":v(()=>[d(c.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":v(()=>[d(c.$slots,"aside-ads-after",{},void 0,!0)]),_:3})])])],2)):g("",!0),h("div",Gn,[h("div",Rn,[d(c.$slots,"doc-before",{},void 0,!0),h("main",xn,[y(f,{class:A(["vp-doc",[i.value,l(t).externalLinkIcon&&"external-link-icon-enabled"]])},null,8,["class"])]),y(Dn,null,{"doc-footer-before":v(()=>[d(c.$slots,"doc-footer-before",{},void 0,!0)]),_:3}),d(c.$slots,"doc-after",{},void 0,!0)])])]),d(c.$slots,"doc-bottom",{},void 0,!0)],2)}}}),Wn=L(Kn,[["__scopeId","data-v-39a288b8"]]),Jn=k({__name:"VPButton",props:{tag:{},size:{default:"medium"},theme:{default:"brand"},text:{},href:{},target:{},rel:{}},setup(e){const t=e,n=V(()=>t.href&&Ye.test(t.href)),s=V(()=>t.tag||t.href?"a":"button");return(o,a)=>(r(),S(oe(s.value),{class:A(["VPButton",[o.size,o.theme]]),href:o.href?l(Ce)(o.href):void 0,target:t.target??(n.value?"_blank":void 0),rel:t.rel??(n.value?"noreferrer":void 0)},{default:v(()=>[J(M(o.text),1)]),_:1},8,["class","href","target","rel"]))}}),Xn=L(Jn,[["__scopeId","data-v-cad61b99"]]),Yn=["src","alt"],Qn=k({inheritAttrs:!1,__name:"VPImage",props:{image:{},alt:{}},setup(e){return(t,n)=>{const s=Z("VPImage",!0);return t.image?(r(),p(C,{key:0},[typeof t.image=="string"||"src"in t.image?(r(),p("img",ue({key:0,class:"VPImage"},typeof t.image=="string"?t.$attrs:{...t.image,...t.$attrs},{src:l(me)(typeof t.image=="string"?t.image:t.image.src),alt:t.alt??(typeof t.image=="string"?"":t.image.alt||"")}),null,16,Yn)):(r(),p(C,{key:1},[y(s,ue({class:"dark",image:t.image.dark,alt:t.image.alt},t.$attrs),null,16,["image","alt"]),y(s,ue({class:"light",image:t.image.light,alt:t.image.alt},t.$attrs),null,16,["image","alt"])],64))],64)):g("",!0)}}}),pe=L(Qn,[["__scopeId","data-v-8426fc1a"]]),Zn=e=>(z("data-v-303bb580"),e=e(),j(),e),es={class:"container"},ts={class:"main"},ns={key:0,class:"name"},ss=["innerHTML"],os=["innerHTML"],as=["innerHTML"],is={key:0,class:"actions"},rs={key:0,class:"image"},ls={class:"image-container"},cs=Zn(()=>h("div",{class:"image-bg"},null,-1)),us=k({__name:"VPHero",props:{name:{},text:{},tagline:{},image:{},actions:{}},setup(e){const t=ke("hero-image-slot-exists");return(n,s)=>(r(),p("div",{class:A(["VPHero",{"has-image":n.image||l(t)}])},[h("div",es,[h("div",ts,[d(n.$slots,"home-hero-info-before",{},void 0,!0),d(n.$slots,"home-hero-info",{},()=>[n.name?(r(),p("h1",ns,[h("span",{innerHTML:n.name,class:"clip"},null,8,ss)])):g("",!0),n.text?(r(),p("p",{key:1,innerHTML:n.text,class:"text"},null,8,os)):g("",!0),n.tagline?(r(),p("p",{key:2,innerHTML:n.tagline,class:"tagline"},null,8,as)):g("",!0)],!0),d(n.$slots,"home-hero-info-after",{},void 0,!0),n.actions?(r(),p("div",is,[(r(!0),p(C,null,F(n.actions,o=>(r(),p("div",{key:o.link,class:"action"},[y(Xn,{tag:"a",size:"medium",theme:o.theme,text:o.text,href:o.link,target:o.target,rel:o.rel},null,8,["theme","text","href","target","rel"])]))),128))])):g("",!0),d(n.$slots,"home-hero-actions-after",{},void 0,!0)]),n.image||l(t)?(r(),p("div",rs,[h("div",ls,[cs,d(n.$slots,"home-hero-image",{},()=>[n.image?(r(),S(pe,{key:0,class:"image-src",image:n.image},null,8,["image"])):g("",!0)],!0)])])):g("",!0)])],2))}}),ds=L(us,[["__scopeId","data-v-303bb580"]]),hs=k({__name:"VPHomeHero",setup(e){const{frontmatter:t}=T();return(n,s)=>l(t).hero?(r(),S(ds,{key:0,class:"VPHomeHero",name:l(t).hero.name,text:l(t).hero.text,tagline:l(t).hero.tagline,image:l(t).hero.image,actions:l(t).hero.actions},{"home-hero-info-before":v(()=>[d(n.$slots,"home-hero-info-before")]),"home-hero-info":v(()=>[d(n.$slots,"home-hero-info")]),"home-hero-info-after":v(()=>[d(n.$slots,"home-hero-info-after")]),"home-hero-actions-after":v(()=>[d(n.$slots,"home-hero-actions-after")]),"home-hero-image":v(()=>[d(n.$slots,"home-hero-image")]),_:3},8,["name","text","tagline","image","actions"])):g("",!0)}}),ps=e=>(z("data-v-a3976bdc"),e=e(),j(),e),vs={class:"box"},fs={key:0,class:"icon"},ms=["innerHTML"],_s=["innerHTML"],gs=["innerHTML"],ks={key:4,class:"link-text"},bs={class:"link-text-value"},$s=ps(()=>h("span",{class:"vpi-arrow-right link-text-icon"},null,-1)),ys=k({__name:"VPFeature",props:{icon:{},title:{},details:{},link:{},linkText:{},rel:{},target:{}},setup(e){return(t,n)=>(r(),S(W,{class:"VPFeature",href:t.link,rel:t.rel,target:t.target,"no-icon":!0,tag:t.link?"a":"div"},{default:v(()=>[h("article",vs,[typeof t.icon=="object"&&t.icon.wrap?(r(),p("div",fs,[y(pe,{image:t.icon,alt:t.icon.alt,height:t.icon.height||48,width:t.icon.width||48},null,8,["image","alt","height","width"])])):typeof t.icon=="object"?(r(),S(pe,{key:1,image:t.icon,alt:t.icon.alt,height:t.icon.height||48,width:t.icon.width||48},null,8,["image","alt","height","width"])):t.icon?(r(),p("div",{key:2,class:"icon",innerHTML:t.icon},null,8,ms)):g("",!0),h("h2",{class:"title",innerHTML:t.title},null,8,_s),t.details?(r(),p("p",{key:3,class:"details",innerHTML:t.details},null,8,gs)):g("",!0),t.linkText?(r(),p("div",ks,[h("p",bs,[J(M(t.linkText)+" ",1),$s])])):g("",!0)])]),_:1},8,["href","rel","target","tag"]))}}),Ps=L(ys,[["__scopeId","data-v-a3976bdc"]]),Vs={key:0,class:"VPFeatures"},Ls={class:"container"},Ss={class:"items"},ws=k({__name:"VPFeatures",props:{features:{}},setup(e){const t=e,n=V(()=>{const s=t.features.length;if(s){if(s===2)return"grid-2";if(s===3)return"grid-3";if(s%3===0)return"grid-6";if(s>3)return"grid-4"}else return});return(s,o)=>s.features?(r(),p("div",Vs,[h("div",Ls,[h("div",Ss,[(r(!0),p(C,null,F(s.features,a=>(r(),p("div",{key:a.title,class:A(["item",[n.value]])},[y(Ps,{icon:a.icon,title:a.title,details:a.details,link:a.link,"link-text":a.linkText,rel:a.rel,target:a.target},null,8,["icon","title","details","link","link-text","rel","target"])],2))),128))])])])):g("",!0)}}),Is=L(ws,[["__scopeId","data-v-a6181336"]]),Ts=k({__name:"VPHomeFeatures",setup(e){const{frontmatter:t}=T();return(n,s)=>l(t).features?(r(),S(Is,{key:0,class:"VPHomeFeatures",features:l(t).features},null,8,["features"])):g("",!0)}}),Ns=k({__name:"VPHomeContent",setup(e){const{width:t}=bt({initialWidth:0,includeScrollbar:!1});return(n,s)=>(r(),p("div",{class:"vp-doc container",style:Qe(l(t)?{"--vp-offset":`calc(50% - ${l(t)/2}px)`}:{})},[d(n.$slots,"default",{},void 0,!0)],4))}}),Ms=L(Ns,[["__scopeId","data-v-8e2d4988"]]),As={class:"VPHome"},Cs=k({__name:"VPHome",setup(e){const{frontmatter:t}=T();return(n,s)=>{const o=Z("Content");return r(),p("div",As,[d(n.$slots,"home-hero-before",{},void 0,!0),y(hs,null,{"home-hero-info-before":v(()=>[d(n.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":v(()=>[d(n.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":v(()=>[d(n.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":v(()=>[d(n.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":v(()=>[d(n.$slots,"home-hero-image",{},void 0,!0)]),_:3}),d(n.$slots,"home-hero-after",{},void 0,!0),d(n.$slots,"home-features-before",{},void 0,!0),y(Ts),d(n.$slots,"home-features-after",{},void 0,!0),l(t).markdownStyles!==!1?(r(),S(Ms,{key:0},{default:v(()=>[y(o)]),_:1})):(r(),S(o,{key:1}))])}}}),Hs=L(Cs,[["__scopeId","data-v-686f80a6"]]),Bs={},Es={class:"VPPage"};function Os(e,t){const n=Z("Content");return r(),p("div",Es,[d(e.$slots,"page-top"),y(n),d(e.$slots,"page-bottom")])}const Ds=L(Bs,[["render",Os]]),Fs=k({__name:"VPContent",setup(e){const{page:t,frontmatter:n}=T(),{hasSidebar:s}=Y();return(o,a)=>(r(),p("div",{class:A(["VPContent",{"has-sidebar":l(s),"is-home":l(n).layout==="home"}]),id:"VPContent"},[l(t).isNotFound?d(o.$slots,"not-found",{key:0},()=>[y(Kt)],!0):l(n).layout==="page"?(r(),S(Ds,{key:1},{"page-top":v(()=>[d(o.$slots,"page-top",{},void 0,!0)]),"page-bottom":v(()=>[d(o.$slots,"page-bottom",{},void 0,!0)]),_:3})):l(n).layout==="home"?(r(),S(Hs,{key:2},{"home-hero-before":v(()=>[d(o.$slots,"home-hero-before",{},void 0,!0)]),"home-hero-info-before":v(()=>[d(o.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":v(()=>[d(o.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":v(()=>[d(o.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":v(()=>[d(o.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":v(()=>[d(o.$slots,"home-hero-image",{},void 0,!0)]),"home-hero-after":v(()=>[d(o.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":v(()=>[d(o.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":v(()=>[d(o.$slots,"home-features-after",{},void 0,!0)]),_:3})):l(n).layout&&l(n).layout!=="doc"?(r(),S(oe(l(n).layout),{key:3})):(r(),S(Wn,{key:4},{"doc-top":v(()=>[d(o.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":v(()=>[d(o.$slots,"doc-bottom",{},void 0,!0)]),"doc-footer-before":v(()=>[d(o.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":v(()=>[d(o.$slots,"doc-before",{},void 0,!0)]),"doc-after":v(()=>[d(o.$slots,"doc-after",{},void 0,!0)]),"aside-top":v(()=>[d(o.$slots,"aside-top",{},void 0,!0)]),"aside-outline-before":v(()=>[d(o.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":v(()=>[d(o.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":v(()=>[d(o.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":v(()=>[d(o.$slots,"aside-ads-after",{},void 0,!0)]),"aside-bottom":v(()=>[d(o.$slots,"aside-bottom",{},void 0,!0)]),_:3}))],2))}}),zs=L(Fs,[["__scopeId","data-v-1428d186"]]),js={class:"container"},Us=["innerHTML"],qs=["innerHTML"],Gs=k({__name:"VPFooter",setup(e){const{theme:t,frontmatter:n}=T(),{hasSidebar:s}=Y();return(o,a)=>l(t).footer&&l(n).footer!==!1?(r(),p("footer",{key:0,class:A(["VPFooter",{"has-sidebar":l(s)}])},[h("div",js,[l(t).footer.message?(r(),p("p",{key:0,class:"message",innerHTML:l(t).footer.message},null,8,Us)):g("",!0),l(t).footer.copyright?(r(),p("p",{key:1,class:"copyright",innerHTML:l(t).footer.copyright},null,8,qs)):g("",!0)])],2)):g("",!0)}}),Rs=L(Gs,[["__scopeId","data-v-e315a0ad"]]);function xs(){const{theme:e,frontmatter:t}=T(),n=Xe([]),s=V(()=>n.value.length>0);return ge(()=>{n.value=He(t.value.outline??e.value.outline)}),{headers:n,hasLocalNav:s}}const Ks=e=>(z("data-v-17a5e62e"),e=e(),j(),e),Ws={class:"menu-text"},Js=Ks(()=>h("span",{class:"vpi-chevron-right icon"},null,-1)),Xs={class:"header"},Ys={class:"outline"},Qs=k({__name:"VPLocalNavOutlineDropdown",props:{headers:{},navHeight:{}},setup(e){const t=e,{theme:n}=T(),s=I(!1),o=I(0),a=I(),i=I();function c(m){var P;(P=a.value)!=null&&P.contains(m.target)||(s.value=!1)}X(s,m=>{if(m){document.addEventListener("click",c);return}document.removeEventListener("click",c)}),$t("Escape",()=>{s.value=!1}),ge(()=>{s.value=!1});function u(){s.value=!s.value,o.value=window.innerHeight+Math.min(window.scrollY-t.navHeight,0)}function f(m){m.target.classList.contains("outline-link")&&(i.value&&(i.value.style.transition="none"),Ae(()=>{s.value=!1}))}function _(){s.value=!1,window.scrollTo({top:0,left:0,behavior:"smooth"})}return(m,P)=>(r(),p("div",{class:"VPLocalNavOutlineDropdown",style:Qe({"--vp-vh":o.value+"px"}),ref_key:"main",ref:a},[m.headers.length>0?(r(),p("button",{key:0,onClick:u,class:A({open:s.value})},[h("span",Ws,M(l(ot)(l(n))),1),Js],2)):(r(),p("button",{key:1,onClick:_},M(l(n).returnToTopLabel||"Return to top"),1)),y(Ne,{name:"flyout"},{default:v(()=>[s.value?(r(),p("div",{key:0,ref_key:"items",ref:i,class:"items",onClick:f},[h("div",Xs,[h("a",{class:"top-link",href:"#",onClick:_},M(l(n).returnToTopLabel||"Return to top"),1)]),h("div",Ys,[y(at,{headers:m.headers},null,8,["headers"])])],512)):g("",!0)]),_:1})],4))}}),Zs=L(Qs,[["__scopeId","data-v-17a5e62e"]]),eo=e=>(z("data-v-a6f0e41e"),e=e(),j(),e),to={class:"container"},no=["aria-expanded"],so=eo(()=>h("span",{class:"vpi-align-left menu-icon"},null,-1)),oo={class:"menu-text"},ao=k({__name:"VPLocalNav",props:{open:{type:Boolean}},emits:["open-menu"],setup(e){const{theme:t,frontmatter:n}=T(),{hasSidebar:s}=Y(),{headers:o}=xs(),{y:a}=Ze(),i=I(0);te(()=>{i.value=parseInt(getComputedStyle(document.documentElement).getPropertyValue("--vp-nav-height"))}),ge(()=>{o.value=He(n.value.outline??t.value.outline)});const c=V(()=>o.value.length===0),u=V(()=>c.value&&!s.value),f=V(()=>({VPLocalNav:!0,"has-sidebar":s.value,empty:c.value,fixed:u.value}));return(_,m)=>l(n).layout!=="home"&&(!u.value||l(a)>=i.value)?(r(),p("div",{key:0,class:A(f.value)},[h("div",to,[l(s)?(r(),p("button",{key:0,class:"menu","aria-expanded":_.open,"aria-controls":"VPSidebarNav",onClick:m[0]||(m[0]=P=>_.$emit("open-menu"))},[so,h("span",oo,M(l(t).sidebarMenuLabel||"Menu"),1)],8,no)):g("",!0),y(Zs,{headers:l(o),navHeight:i.value},null,8,["headers","navHeight"])])],2)):g("",!0)}}),io=L(ao,[["__scopeId","data-v-a6f0e41e"]]);function ro(){const e=I(!1);function t(){e.value=!0,window.addEventListener("resize",o)}function n(){e.value=!1,window.removeEventListener("resize",o)}function s(){e.value?n():t()}function o(){window.outerWidth>=768&&n()}const a=ie();return X(()=>a.path,n),{isScreenOpen:e,openScreen:t,closeScreen:n,toggleScreen:s}}const lo={},co={class:"VPSwitch",type:"button",role:"switch"},uo={class:"check"},ho={key:0,class:"icon"};function po(e,t){return r(),p("button",co,[h("span",uo,[e.$slots.default?(r(),p("span",ho,[d(e.$slots,"default",{},void 0,!0)])):g("",!0)])])}const vo=L(lo,[["render",po],["__scopeId","data-v-1d5665e3"]]),rt=e=>(z("data-v-d1f28634"),e=e(),j(),e),fo=rt(()=>h("span",{class:"vpi-sun sun"},null,-1)),mo=rt(()=>h("span",{class:"vpi-moon moon"},null,-1)),_o=k({__name:"VPSwitchAppearance",setup(e){const{isDark:t,theme:n}=T(),s=ke("toggle-appearance",()=>{t.value=!t.value}),o=V(()=>t.value?n.value.lightModeSwitchTitle||"Switch to light theme":n.value.darkModeSwitchTitle||"Switch to dark theme");return(a,i)=>(r(),S(vo,{title:o.value,class:"VPSwitchAppearance","aria-checked":l(t),onClick:l(s)},{default:v(()=>[fo,mo]),_:1},8,["title","aria-checked","onClick"]))}}),Be=L(_o,[["__scopeId","data-v-d1f28634"]]),go={key:0,class:"VPNavBarAppearance"},ko=k({__name:"VPNavBarAppearance",setup(e){const{site:t}=T();return(n,s)=>l(t).appearance&&l(t).appearance!=="force-dark"?(r(),p("div",go,[y(Be)])):g("",!0)}}),bo=L(ko,[["__scopeId","data-v-e6aabb21"]]),Ee=I();let lt=!1,ye=0;function $o(e){const t=I(!1);if(be){!lt&&yo(),ye++;const n=X(Ee,s=>{var o,a,i;s===e.el.value||(o=e.el.value)!=null&&o.contains(s)?(t.value=!0,(a=e.onFocus)==null||a.call(e)):(t.value=!1,(i=e.onBlur)==null||i.call(e))});Me(()=>{n(),ye--,ye||Po()})}return yt(t)}function yo(){document.addEventListener("focusin",ct),lt=!0,Ee.value=document.activeElement}function Po(){document.removeEventListener("focusin",ct)}function ct(){Ee.value=document.activeElement}const Vo={class:"VPMenuLink"},Lo=k({__name:"VPMenuLink",props:{item:{}},setup(e){const{page:t}=T();return(n,s)=>(r(),p("div",Vo,[y(W,{class:A({active:l(ee)(l(t).relativePath,n.item.activeMatch||n.item.link,!!n.item.activeMatch)}),href:n.item.link,target:n.item.target,rel:n.item.rel},{default:v(()=>[J(M(n.item.text),1)]),_:1},8,["class","href","target","rel"])]))}}),$e=L(Lo,[["__scopeId","data-v-43f1e123"]]),So={class:"VPMenuGroup"},wo={key:0,class:"title"},Io=k({__name:"VPMenuGroup",props:{text:{},items:{}},setup(e){return(t,n)=>(r(),p("div",So,[t.text?(r(),p("p",wo,M(t.text),1)):g("",!0),(r(!0),p(C,null,F(t.items,s=>(r(),p(C,null,["link"in s?(r(),S($e,{key:0,item:s},null,8,["item"])):g("",!0)],64))),256))]))}}),To=L(Io,[["__scopeId","data-v-69e747b5"]]),No={class:"VPMenu"},Mo={key:0,class:"items"},Ao=k({__name:"VPMenu",props:{items:{}},setup(e){return(t,n)=>(r(),p("div",No,[t.items?(r(),p("div",Mo,[(r(!0),p(C,null,F(t.items,s=>(r(),p(C,{key:s.text},["link"in s?(r(),S($e,{key:0,item:s},null,8,["item"])):(r(),S(To,{key:1,text:s.text,items:s.items},null,8,["text","items"]))],64))),128))])):g("",!0),d(t.$slots,"default",{},void 0,!0)]))}}),Co=L(Ao,[["__scopeId","data-v-e7ea1737"]]),Ho=e=>(z("data-v-b6c34ac9"),e=e(),j(),e),Bo=["aria-expanded","aria-label"],Eo={key:0,class:"text"},Oo=["innerHTML"],Do=Ho(()=>h("span",{class:"vpi-chevron-down text-icon"},null,-1)),Fo={key:1,class:"vpi-more-horizontal icon"},zo={class:"menu"},jo=k({__name:"VPFlyout",props:{icon:{},button:{},label:{},items:{}},setup(e){const t=I(!1),n=I();$o({el:n,onBlur:s});function s(){t.value=!1}return(o,a)=>(r(),p("div",{class:"VPFlyout",ref_key:"el",ref:n,onMouseenter:a[1]||(a[1]=i=>t.value=!0),onMouseleave:a[2]||(a[2]=i=>t.value=!1)},[h("button",{type:"button",class:"button","aria-haspopup":"true","aria-expanded":t.value,"aria-label":o.label,onClick:a[0]||(a[0]=i=>t.value=!t.value)},[o.button||o.icon?(r(),p("span",Eo,[o.icon?(r(),p("span",{key:0,class:A([o.icon,"option-icon"])},null,2)):g("",!0),o.button?(r(),p("span",{key:1,innerHTML:o.button},null,8,Oo)):g("",!0),Do])):(r(),p("span",Fo))],8,Bo),h("div",zo,[y(Co,{items:o.items},{default:v(()=>[d(o.$slots,"default",{},void 0,!0)]),_:3},8,["items"])])],544))}}),Oe=L(jo,[["__scopeId","data-v-b6c34ac9"]]),Uo=["href","aria-label","innerHTML"],qo=k({__name:"VPSocialLink",props:{icon:{},link:{},ariaLabel:{}},setup(e){const t=e,n=V(()=>typeof t.icon=="object"?t.icon.svg:``);return(s,o)=>(r(),p("a",{class:"VPSocialLink no-icon",href:s.link,"aria-label":s.ariaLabel??(typeof s.icon=="string"?s.icon:""),target:"_blank",rel:"noopener",innerHTML:n.value},null,8,Uo))}}),Go=L(qo,[["__scopeId","data-v-eee4e7cb"]]),Ro={class:"VPSocialLinks"},xo=k({__name:"VPSocialLinks",props:{links:{}},setup(e){return(t,n)=>(r(),p("div",Ro,[(r(!0),p(C,null,F(t.links,({link:s,icon:o,ariaLabel:a})=>(r(),S(Go,{key:s,icon:o,link:s,ariaLabel:a},null,8,["icon","link","ariaLabel"]))),128))]))}}),De=L(xo,[["__scopeId","data-v-7bc22406"]]),Ko={key:0,class:"group translations"},Wo={class:"trans-title"},Jo={key:1,class:"group"},Xo={class:"item appearance"},Yo={class:"label"},Qo={class:"appearance-action"},Zo={key:2,class:"group"},ea={class:"item social-links"},ta=k({__name:"VPNavBarExtra",setup(e){const{site:t,theme:n}=T(),{localeLinks:s,currentLang:o}=re({correspondingLink:!0}),a=V(()=>s.value.length&&o.value.label||t.value.appearance||n.value.socialLinks);return(i,c)=>a.value?(r(),S(Oe,{key:0,class:"VPNavBarExtra",label:"extra navigation"},{default:v(()=>[l(s).length&&l(o).label?(r(),p("div",Ko,[h("p",Wo,M(l(o).label),1),(r(!0),p(C,null,F(l(s),u=>(r(),S($e,{key:u.link,item:u},null,8,["item"]))),128))])):g("",!0),l(t).appearance&&l(t).appearance!=="force-dark"?(r(),p("div",Jo,[h("div",Xo,[h("p",Yo,M(l(n).darkModeSwitchLabel||"Appearance"),1),h("div",Qo,[y(Be)])])])):g("",!0),l(n).socialLinks?(r(),p("div",Zo,[h("div",ea,[y(De,{class:"social-links-list",links:l(n).socialLinks},null,8,["links"])])])):g("",!0)]),_:1})):g("",!0)}}),na=L(ta,[["__scopeId","data-v-d0bd9dde"]]),sa=e=>(z("data-v-e5dd9c1c"),e=e(),j(),e),oa=["aria-expanded"],aa=sa(()=>h("span",{class:"container"},[h("span",{class:"top"}),h("span",{class:"middle"}),h("span",{class:"bottom"})],-1)),ia=[aa],ra=k({__name:"VPNavBarHamburger",props:{active:{type:Boolean}},emits:["click"],setup(e){return(t,n)=>(r(),p("button",{type:"button",class:A(["VPNavBarHamburger",{active:t.active}]),"aria-label":"mobile navigation","aria-expanded":t.active,"aria-controls":"VPNavScreen",onClick:n[0]||(n[0]=s=>t.$emit("click"))},ia,10,oa))}}),la=L(ra,[["__scopeId","data-v-e5dd9c1c"]]),ca=["innerHTML"],ua=k({__name:"VPNavBarMenuLink",props:{item:{}},setup(e){const{page:t}=T();return(n,s)=>(r(),S(W,{class:A({VPNavBarMenuLink:!0,active:l(ee)(l(t).relativePath,n.item.activeMatch||n.item.link,!!n.item.activeMatch)}),href:n.item.link,noIcon:n.item.noIcon,target:n.item.target,rel:n.item.rel,tabindex:"0"},{default:v(()=>[h("span",{innerHTML:n.item.text},null,8,ca)]),_:1},8,["class","href","noIcon","target","rel"]))}}),da=L(ua,[["__scopeId","data-v-9c663999"]]),ha=k({__name:"VPNavBarMenuGroup",props:{item:{}},setup(e){const t=e,{page:n}=T(),s=a=>"link"in a?ee(n.value.relativePath,a.link,!!t.item.activeMatch):a.items.some(s),o=V(()=>s(t.item));return(a,i)=>(r(),S(Oe,{class:A({VPNavBarMenuGroup:!0,active:l(ee)(l(n).relativePath,a.item.activeMatch,!!a.item.activeMatch)||o.value}),button:a.item.text,items:a.item.items},null,8,["class","button","items"]))}}),pa=e=>(z("data-v-7f418b0f"),e=e(),j(),e),va={key:0,"aria-labelledby":"main-nav-aria-label",class:"VPNavBarMenu"},fa=pa(()=>h("span",{id:"main-nav-aria-label",class:"visually-hidden"},"Main Navigation",-1)),ma=k({__name:"VPNavBarMenu",setup(e){const{theme:t}=T();return(n,s)=>l(t).nav?(r(),p("nav",va,[fa,(r(!0),p(C,null,F(l(t).nav,o=>(r(),p(C,{key:o.text},["link"in o?(r(),S(da,{key:0,item:o},null,8,["item"])):(r(),S(ha,{key:1,item:o},null,8,["item"]))],64))),128))])):g("",!0)}}),_a=L(ma,[["__scopeId","data-v-7f418b0f"]]),ga="/assets/flex-logo.BJA2J7hW.svg";function Pe(e,t){return typeof e>"u"?t:e}function Ue(e){const t=Array(e);for(let n=0;n=this.minlength&&(c||!i[_])){let P=ce(u,o,f),b="";switch(this.tokenize){case"full":if(3$;N--)if(N-$>=this.minlength){const w=ce(u,o,f,m,$);b=_.substring($,N),this.push_index(i,b,w,e,n)}break}case"reverse":if(2=this.minlength){const N=ce(u,o,f,m,$);this.push_index(i,b,N,e,n)}b=""}case"forward":if(1=this.minlength&&this.push_index(i,b,P,e,n);break}default:if(this.boost&&(P=Math.min(0|P/this.boost(t,_,f),u-1)),this.push_index(i,_,P,e,n),c&&1=this.minlength&&!$[_]){$[_]=1;const K=ce(N+(o/2>N?0:1),o,f,U-1,D-1),Q=this.bidirectional&&_>w;this.push_index(a,Q?w:_,K,e,n,Q?_:w)}}}}}this.fastupdate||(this.register[e]=1)}}return this};function ce(e,t,n,s,o){return n&&1=this.minlength&&!m[b]){if(!this.optimize&&!a&&!this.map[b])return i;P[N++]=b,m[b]=1}e=P,s=e.length}if(!s)return i;t||(t=100);let u,f=this.depth&&1=n)))));b++);if(f)return o?Re(c,n,0):void(e[e.length]=c)}return!t&&c};function Re(e,t,n){return e=e.length===1?e[0]:ba(e),n||e.length>t?e.slice(n,n+t):e}function xe(e,t,n,s){if(n){const o=s&&t>n;e=e[o?t:n],e=e&&e[o?n:t]}else e=e[t];return e}R.prototype.contain=function(e){return!!this.register[e]},R.prototype.update=function(e,t){return this.remove(e).add(e,t)},R.prototype.remove=function(e,t){const n=this.register[e];if(n){if(this.fastupdate)for(let s,o=0;o{if(a.value){for(var B=m.value.search(a.value,{enrich:!0}),H=[],q=0;q!B||!B.length?[]:B.reduce((q,E)=>(q[H(E)]||(q[H(E)]=[]),q[H(E)].push(E),q),{}),K=()=>{setTimeout(()=>{c.value&&c.value.focus()},100),Fe(),o.value=!0};te(async()=>{var E,O;const B=await Vt(()=>import("./virtual_search-data.CaVNr-Kv.js"),[]);u.value=B.default.INDEX_DATA,f.value=B.default.PREVIEW_LOOKUP,_.value=B.default.Options,i.value=window.location.origin+me(n.value==="root"?"/":n.value),P.value=((E=_.value)==null?void 0:E.buttonLabel)||P.value,b.value=((O=_.value)==null?void 0:O.placeholder)||b.value;var H=new R(_.value);H.import("reg",u.value.reg),H.import("cfg",u.value.cfg),H.import("map",u.value.map),H.import("ctx",u.value.ctx),m.value=H,s.value.innerHTML=/(Mac|iPhone|iPod|iPad)/i.test(navigator.platform)?"⌘":"Ctrl";const q=G=>{var se;G.key==="k"&&(G.ctrlKey||G.metaKey)&&(G.preventDefault(),K()),G.key==="Escape"&&((se=a.value)==null?void 0:se.length)==0&&o.value&&(o.value=!1)};window.addEventListener("keydown",q)});const Q=V(()=>D(U.value,B=>B.link.split("/").slice(0,-1).join("-"))),ne=V(()=>Object.values(Q.value).flat().map(B=>B.id));function Fe(){o.value=!1,a.value=""}const vt=B=>{var H,q;if(document.getElementsByClassName("search-group")[0]){if(B.key=="ArrowUp"||B.key=="ArrowDown"){const E=ne.value.indexOf($.value);if(B.key=="ArrowUp"){const O=E==0?ne.value.length-1:E-1;$.value=ne.value[O]}if(B.key=="ArrowDown"){const O=E>ne.value.length-2?0:E+1;$.value=ne.value[O]}if(E<5){const O=N.value.getElementsByClassName("VPPluginSearch-search-group")[0];O==null||O.scrollIntoView(!0)}else(H=document.getElementById(ne.value[$.value]))==null||H.scrollIntoView(!0);Ae()}B.key=="Enter"&&w.go(t.site.value.base+((q=N.value.getElementsByClassName("link-focused")[0].getAttribute("href"))==null?void 0:q.replace(i.value,"")))}};return(B,H)=>{const q=Z("ClientOnly");return r(),p("div",za,[y(q,null,{default:v(()=>[(r(),S(wt,{to:"body"},[ze(h("div",{class:"VPPluginSearch-modal-back",onClick:H[2]||(H[2]=E=>o.value=!1),onKeydown:vt},[h("div",{class:"VPPluginSearch-modal",onClick:H[1]||(H[1]=et(()=>{},["stop"])),ref_key:"modal",ref:N},[h("form",ja,[Ua,ze(h("input",{class:"DocSearch-Input","aria-autocomplete":"both","aria-labelledby":"docsearch-label",id:"docsearch-input",autocomplete:"off",autocorrect:"off",autocapitalize:"off",enterkeyhint:"search",spellcheck:"false",autofocus:"true","onUpdate:modelValue":H[0]||(H[0]=E=>a.value=E),placeholder:b.value,maxlength:"64",type:"search",ref_key:"input",ref:c},null,8,qa),[[St,a.value]])]),h("div",Ga,[(r(!0),p(C,null,F(Q.value,(E,O)=>(r(),p("div",{class:"search-group",key:O},[h("span",Ra,M(O?O.toString()[0].toUpperCase()+O.toString().slice(1):"Home"),1),(r(!0),p(C,null,F(E,(G,se)=>(r(),p("a",{href:i.value+G.link,key:G.id,onClick:Fe,onMouseenter:le=>$.value=G.id,class:A({"link-focused":$.value==G.id}),id:se.toString()},[h("div",Ka,[h("span",Wa,M(G.link.includes("#")?"#":"▤"),1),h("div",Ja,[h("h3",null,M(G.title),1),h("p",null,[h("div",{innerHTML:G.preview},null,8,Xa)])]),Ya])],42,xa))),128))]))),128))]),Qa],512)],544),[[Lt,o.value]])]))]),_:1}),h("div",{id:"docsearch",onClick:H[3]||(H[3]=E=>K())},[h("button",Za,[h("span",ei,[ti,h("span",ni,M(P.value),1)]),h("span",si,[h("span",{class:"DocSearch-Button-Key",ref_key:"metaKey",ref:s},"Meta",512),oi])])])])}}}),ii=k({__name:"VPNavBarSocialLinks",setup(e){const{theme:t}=T();return(n,s)=>l(t).socialLinks?(r(),S(De,{key:0,class:"VPNavBarSocialLinks",links:l(t).socialLinks},null,8,["links"])):g("",!0)}}),ri=L(ii,[["__scopeId","data-v-0394ad82"]]),li=["href","rel","target"],ci={key:1},ui={key:2},di=k({__name:"VPNavBarTitle",setup(e){const{site:t,theme:n}=T(),{hasSidebar:s}=Y(),{currentLang:o}=re(),a=V(()=>{var u;return typeof n.value.logoLink=="string"?n.value.logoLink:(u=n.value.logoLink)==null?void 0:u.link}),i=V(()=>{var u;return typeof n.value.logoLink=="string"||(u=n.value.logoLink)==null?void 0:u.rel}),c=V(()=>{var u;return typeof n.value.logoLink=="string"||(u=n.value.logoLink)==null?void 0:u.target});return(u,f)=>(r(),p("div",{class:A(["VPNavBarTitle",{"has-sidebar":l(s)}])},[h("a",{class:"title",href:a.value??l(Ce)(l(o).link),rel:i.value,target:c.value},[d(u.$slots,"nav-bar-title-before",{},void 0,!0),l(n).logo?(r(),S(pe,{key:0,class:"logo",image:l(n).logo},null,8,["image"])):g("",!0),l(n).siteTitle?(r(),p("span",ci,M(l(n).siteTitle),1)):l(n).siteTitle===void 0?(r(),p("span",ui,M(l(t).title),1)):g("",!0),d(u.$slots,"nav-bar-title-after",{},void 0,!0)],8,li)],2))}}),hi=L(di,[["__scopeId","data-v-ab179fa1"]]),pi={class:"items"},vi={class:"title"},fi=k({__name:"VPNavBarTranslations",setup(e){const{theme:t}=T(),{localeLinks:n,currentLang:s}=re({correspondingLink:!0});return(o,a)=>l(n).length&&l(s).label?(r(),S(Oe,{key:0,class:"VPNavBarTranslations",icon:"vpi-languages",label:l(t).langMenuLabel||"Change language"},{default:v(()=>[h("div",pi,[h("p",vi,M(l(s).label),1),(r(!0),p(C,null,F(l(n),i=>(r(),S($e,{key:i.link,item:i},null,8,["item"]))),128))])]),_:1},8,["label"])):g("",!0)}}),mi=L(fi,[["__scopeId","data-v-88af2de4"]]),_i=e=>(z("data-v-ccf7ddec"),e=e(),j(),e),gi={class:"wrapper"},ki={class:"container"},bi={class:"title"},$i={class:"content"},yi={class:"content-body"},Pi=_i(()=>h("div",{class:"divider"},[h("div",{class:"divider-line"})],-1)),Vi=k({__name:"VPNavBar",props:{isScreenOpen:{type:Boolean}},emits:["toggle-screen"],setup(e){const{y:t}=Ze(),{hasSidebar:n}=Y(),{frontmatter:s}=T(),o=I({});return Je(()=>{o.value={"has-sidebar":n.value,home:s.value.layout==="home",top:t.value===0}}),(a,i)=>(r(),p("div",{class:A(["VPNavBar",o.value])},[h("div",gi,[h("div",ki,[h("div",bi,[y(hi,null,{"nav-bar-title-before":v(()=>[d(a.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":v(()=>[d(a.$slots,"nav-bar-title-after",{},void 0,!0)]),_:3})]),h("div",$i,[h("div",yi,[d(a.$slots,"nav-bar-content-before",{},void 0,!0),y(ai,{class:"search"}),y(_a,{class:"menu"}),y(mi,{class:"translations"}),y(bo,{class:"appearance"}),y(ri,{class:"social-links"}),y(na,{class:"extra"}),d(a.$slots,"nav-bar-content-after",{},void 0,!0),y(la,{class:"hamburger",active:a.isScreenOpen,onClick:i[0]||(i[0]=c=>a.$emit("toggle-screen"))},null,8,["active"])])])])]),Pi],2))}}),Li=L(Vi,[["__scopeId","data-v-ccf7ddec"]]),Si={key:0,class:"VPNavScreenAppearance"},wi={class:"text"},Ii=k({__name:"VPNavScreenAppearance",setup(e){const{site:t,theme:n}=T();return(s,o)=>l(t).appearance&&l(t).appearance!=="force-dark"?(r(),p("div",Si,[h("p",wi,M(l(n).darkModeSwitchLabel||"Appearance"),1),y(Be)])):g("",!0)}}),Ti=L(Ii,[["__scopeId","data-v-2d7af913"]]),Ni=k({__name:"VPNavScreenMenuLink",props:{item:{}},setup(e){const t=ke("close-screen");return(n,s)=>(r(),S(W,{class:"VPNavScreenMenuLink",href:n.item.link,target:n.item.target,rel:n.item.rel,onClick:l(t),innerHTML:n.item.text},null,8,["href","target","rel","onClick","innerHTML"]))}}),Mi=L(Ni,[["__scopeId","data-v-7f31e1f6"]]),Ai=k({__name:"VPNavScreenMenuGroupLink",props:{item:{}},setup(e){const t=ke("close-screen");return(n,s)=>(r(),S(W,{class:"VPNavScreenMenuGroupLink",href:n.item.link,target:n.item.target,rel:n.item.rel,onClick:l(t)},{default:v(()=>[J(M(n.item.text),1)]),_:1},8,["href","target","rel","onClick"]))}}),ut=L(Ai,[["__scopeId","data-v-19976ae1"]]),Ci={class:"VPNavScreenMenuGroupSection"},Hi={key:0,class:"title"},Bi=k({__name:"VPNavScreenMenuGroupSection",props:{text:{},items:{}},setup(e){return(t,n)=>(r(),p("div",Ci,[t.text?(r(),p("p",Hi,M(t.text),1)):g("",!0),(r(!0),p(C,null,F(t.items,s=>(r(),S(ut,{key:s.text,item:s},null,8,["item"]))),128))]))}}),Ei=L(Bi,[["__scopeId","data-v-8133b170"]]),Oi=e=>(z("data-v-ff6087d4"),e=e(),j(),e),Di=["aria-controls","aria-expanded"],Fi=["innerHTML"],zi=Oi(()=>h("span",{class:"vpi-plus button-icon"},null,-1)),ji=["id"],Ui={key:1,class:"group"},qi=k({__name:"VPNavScreenMenuGroup",props:{text:{},items:{}},setup(e){const t=e,n=I(!1),s=V(()=>`NavScreenGroup-${t.text.replace(" ","-").toLowerCase()}`);function o(){n.value=!n.value}return(a,i)=>(r(),p("div",{class:A(["VPNavScreenMenuGroup",{open:n.value}])},[h("button",{class:"button","aria-controls":s.value,"aria-expanded":n.value,onClick:o},[h("span",{class:"button-text",innerHTML:a.text},null,8,Fi),zi],8,Di),h("div",{id:s.value,class:"items"},[(r(!0),p(C,null,F(a.items,c=>(r(),p(C,{key:c.text},["link"in c?(r(),p("div",{key:c.text,class:"item"},[y(ut,{item:c},null,8,["item"])])):(r(),p("div",Ui,[y(Ei,{text:c.text,items:c.items},null,8,["text","items"])]))],64))),128))],8,ji)],2))}}),Gi=L(qi,[["__scopeId","data-v-ff6087d4"]]),Ri={key:0,class:"VPNavScreenMenu"},xi=k({__name:"VPNavScreenMenu",setup(e){const{theme:t}=T();return(n,s)=>l(t).nav?(r(),p("nav",Ri,[(r(!0),p(C,null,F(l(t).nav,o=>(r(),p(C,{key:o.text},["link"in o?(r(),S(Mi,{key:0,item:o},null,8,["item"])):(r(),S(Gi,{key:1,text:o.text||"",items:o.items},null,8,["text","items"]))],64))),128))])):g("",!0)}}),Ki=k({__name:"VPNavScreenSocialLinks",setup(e){const{theme:t}=T();return(n,s)=>l(t).socialLinks?(r(),S(De,{key:0,class:"VPNavScreenSocialLinks",links:l(t).socialLinks},null,8,["links"])):g("",!0)}}),dt=e=>(z("data-v-858fe1a4"),e=e(),j(),e),Wi=dt(()=>h("span",{class:"vpi-languages icon lang"},null,-1)),Ji=dt(()=>h("span",{class:"vpi-chevron-down icon chevron"},null,-1)),Xi={class:"list"},Yi=k({__name:"VPNavScreenTranslations",setup(e){const{localeLinks:t,currentLang:n}=re({correspondingLink:!0}),s=I(!1);function o(){s.value=!s.value}return(a,i)=>l(t).length&&l(n).label?(r(),p("div",{key:0,class:A(["VPNavScreenTranslations",{open:s.value}])},[h("button",{class:"title",onClick:o},[Wi,J(" "+M(l(n).label)+" ",1),Ji]),h("ul",Xi,[(r(!0),p(C,null,F(l(t),c=>(r(),p("li",{key:c.link,class:"item"},[y(W,{class:"link",href:c.link},{default:v(()=>[J(M(c.text),1)]),_:2},1032,["href"])]))),128))])],2)):g("",!0)}}),Qi=L(Yi,[["__scopeId","data-v-858fe1a4"]]),Zi={class:"container"},er=k({__name:"VPNavScreen",props:{open:{type:Boolean}},setup(e){const t=I(null),n=tt(be?document.body:null);return(s,o)=>(r(),S(Ne,{name:"fade",onEnter:o[0]||(o[0]=a=>n.value=!0),onAfterLeave:o[1]||(o[1]=a=>n.value=!1)},{default:v(()=>[s.open?(r(),p("div",{key:0,class:"VPNavScreen",ref_key:"screen",ref:t,id:"VPNavScreen"},[h("div",Zi,[d(s.$slots,"nav-screen-content-before",{},void 0,!0),y(xi,{class:"menu"}),y(Qi,{class:"translations"}),y(Ti,{class:"appearance"}),y(Ki,{class:"social-links"}),d(s.$slots,"nav-screen-content-after",{},void 0,!0)])],512)):g("",!0)]),_:3}))}}),tr=L(er,[["__scopeId","data-v-cc5739dd"]]),nr={key:0,class:"VPNav"},sr=k({__name:"VPNav",setup(e){const{isScreenOpen:t,closeScreen:n,toggleScreen:s}=ro(),{frontmatter:o}=T(),a=V(()=>o.value.navbar!==!1);return nt("close-screen",n),_e(()=>{be&&document.documentElement.classList.toggle("hide-nav",!a.value)}),(i,c)=>a.value?(r(),p("header",nr,[y(Li,{"is-screen-open":l(t),onToggleScreen:l(s)},{"nav-bar-title-before":v(()=>[d(i.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":v(()=>[d(i.$slots,"nav-bar-title-after",{},void 0,!0)]),"nav-bar-content-before":v(()=>[d(i.$slots,"nav-bar-content-before",{},void 0,!0)]),"nav-bar-content-after":v(()=>[d(i.$slots,"nav-bar-content-after",{},void 0,!0)]),_:3},8,["is-screen-open","onToggleScreen"]),y(tr,{open:l(t)},{"nav-screen-content-before":v(()=>[d(i.$slots,"nav-screen-content-before",{},void 0,!0)]),"nav-screen-content-after":v(()=>[d(i.$slots,"nav-screen-content-after",{},void 0,!0)]),_:3},8,["open"])])):g("",!0)}}),or=L(sr,[["__scopeId","data-v-ae24b3ad"]]),ht=e=>(z("data-v-b8d55f3b"),e=e(),j(),e),ar=["role","tabindex"],ir=ht(()=>h("div",{class:"indicator"},null,-1)),rr=["onKeydown"],lr=ht(()=>h("span",{class:"vpi-chevron-right caret-icon"},null,-1)),cr=[lr],ur={key:1,class:"items"},dr=k({__name:"VPSidebarItem",props:{item:{},depth:{}},setup(e){const t=e,{collapsed:n,collapsible:s,isLink:o,isActiveLink:a,hasActiveLink:i,hasChildren:c,toggle:u}=Yt(V(()=>t.item)),f=V(()=>c.value?"section":"div"),_=V(()=>o.value?"a":"div"),m=V(()=>c.value?t.depth+2===7?"p":`h${t.depth+2}`:"p"),P=V(()=>o.value?void 0:"button"),b=V(()=>[[`level-${t.depth}`],{collapsible:s.value},{collapsed:n.value},{"is-link":o.value},{"is-active":a.value},{"has-active":i.value}]);function $(w){"key"in w&&w.key!=="Enter"||!t.item.link&&u()}function N(){t.item.link&&u()}return(w,U)=>{const D=Z("VPSidebarItem",!0);return r(),S(oe(f.value),{class:A(["VPSidebarItem",b.value])},{default:v(()=>[w.item.text?(r(),p("div",ue({key:0,class:"item",role:P.value},Tt(w.item.items?{click:$,keydown:$}:{},!0),{tabindex:w.item.items&&0}),[ir,w.item.link?(r(),S(W,{key:0,tag:_.value,class:"link",href:w.item.link,rel:w.item.rel,target:w.item.target},{default:v(()=>[(r(),S(oe(m.value),{class:"text",innerHTML:w.item.text},null,8,["innerHTML"]))]),_:1},8,["tag","href","rel","target"])):(r(),S(oe(m.value),{key:1,class:"text",innerHTML:w.item.text},null,8,["innerHTML"])),w.item.collapsed!=null&&w.item.items&&w.item.items.length?(r(),p("div",{key:2,class:"caret",role:"button","aria-label":"toggle section",onClick:N,onKeydown:It(N,["enter"]),tabindex:"0"},cr,40,rr)):g("",!0)],16,ar)):g("",!0),w.item.items&&w.item.items.length?(r(),p("div",ur,[w.depth<5?(r(!0),p(C,{key:0},F(w.item.items,K=>(r(),S(D,{key:K.text,item:K,depth:w.depth+1},null,8,["item","depth"]))),128)):g("",!0)])):g("",!0)]),_:1},8,["class"])}}}),hr=L(dr,[["__scopeId","data-v-b8d55f3b"]]),pt=e=>(z("data-v-575e6a36"),e=e(),j(),e),pr=pt(()=>h("div",{class:"curtain"},null,-1)),vr={class:"nav",id:"VPSidebarNav","aria-labelledby":"sidebar-aria-label",tabindex:"-1"},fr=pt(()=>h("span",{class:"visually-hidden",id:"sidebar-aria-label"}," Sidebar Navigation ",-1)),mr=k({__name:"VPSidebar",props:{open:{type:Boolean}},setup(e){const t=e,{sidebarGroups:n,hasSidebar:s}=Y(),o=I(null),a=tt(be?document.body:null);return X([t,o],()=>{var i;t.open?(a.value=!0,(i=o.value)==null||i.focus()):a.value=!1},{immediate:!0,flush:"post"}),(i,c)=>l(s)?(r(),p("aside",{key:0,class:A(["VPSidebar",{open:i.open}]),ref_key:"navEl",ref:o,onClick:c[0]||(c[0]=et(()=>{},["stop"]))},[pr,h("nav",vr,[fr,d(i.$slots,"sidebar-nav-before",{},void 0,!0),(r(!0),p(C,null,F(l(n),u=>(r(),p("div",{key:u.text,class:"group"},[y(hr,{item:u,depth:0},null,8,["item"])]))),128)),d(i.$slots,"sidebar-nav-after",{},void 0,!0)])],2)):g("",!0)}}),_r=L(mr,[["__scopeId","data-v-575e6a36"]]),gr=k({__name:"VPSkipLink",setup(e){const t=ie(),n=I();X(()=>t.path,()=>n.value.focus());function s({target:o}){const a=document.getElementById(decodeURIComponent(o.hash).slice(1));if(a){const i=()=>{a.removeAttribute("tabindex"),a.removeEventListener("blur",i)};a.setAttribute("tabindex","-1"),a.addEventListener("blur",i),a.focus(),window.scrollTo(0,0)}}return(o,a)=>(r(),p(C,null,[h("span",{ref_key:"backToTop",ref:n,tabindex:"-1"},null,512),h("a",{href:"#VPContent",class:"VPSkipLink visually-hidden",onClick:s}," Skip to content ")],64))}}),kr=L(gr,[["__scopeId","data-v-0f60ec36"]]),br=k({__name:"Layout",setup(e){const{isOpen:t,open:n,close:s}=Y(),o=ie();X(()=>o.path,s),Xt(t,s);const{frontmatter:a}=T(),i=Nt(),c=V(()=>!!i["home-hero-image"]);return nt("hero-image-slot-exists",c),(u,f)=>{const _=Z("Content");return l(a).layout!==!1?(r(),p("div",{key:0,class:A(["Layout",l(a).pageClass])},[d(u.$slots,"layout-top",{},void 0,!0),y(kr),y(Bt,{class:"backdrop",show:l(t),onClick:l(s)},null,8,["show","onClick"]),y(or,null,{"nav-bar-title-before":v(()=>[d(u.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":v(()=>[d(u.$slots,"nav-bar-title-after",{},void 0,!0)]),"nav-bar-content-before":v(()=>[d(u.$slots,"nav-bar-content-before",{},void 0,!0)]),"nav-bar-content-after":v(()=>[d(u.$slots,"nav-bar-content-after",{},void 0,!0)]),"nav-screen-content-before":v(()=>[d(u.$slots,"nav-screen-content-before",{},void 0,!0)]),"nav-screen-content-after":v(()=>[d(u.$slots,"nav-screen-content-after",{},void 0,!0)]),_:3}),y(io,{open:l(t),onOpenMenu:l(n)},null,8,["open","onOpenMenu"]),y(_r,{open:l(t)},{"sidebar-nav-before":v(()=>[d(u.$slots,"sidebar-nav-before",{},void 0,!0)]),"sidebar-nav-after":v(()=>[d(u.$slots,"sidebar-nav-after",{},void 0,!0)]),_:3},8,["open"]),y(zs,null,{"page-top":v(()=>[d(u.$slots,"page-top",{},void 0,!0)]),"page-bottom":v(()=>[d(u.$slots,"page-bottom",{},void 0,!0)]),"not-found":v(()=>[d(u.$slots,"not-found",{},void 0,!0)]),"home-hero-before":v(()=>[d(u.$slots,"home-hero-before",{},void 0,!0)]),"home-hero-info-before":v(()=>[d(u.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":v(()=>[d(u.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":v(()=>[d(u.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":v(()=>[d(u.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":v(()=>[d(u.$slots,"home-hero-image",{},void 0,!0)]),"home-hero-after":v(()=>[d(u.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":v(()=>[d(u.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":v(()=>[d(u.$slots,"home-features-after",{},void 0,!0)]),"doc-footer-before":v(()=>[d(u.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":v(()=>[d(u.$slots,"doc-before",{},void 0,!0)]),"doc-after":v(()=>[d(u.$slots,"doc-after",{},void 0,!0)]),"doc-top":v(()=>[d(u.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":v(()=>[d(u.$slots,"doc-bottom",{},void 0,!0)]),"aside-top":v(()=>[d(u.$slots,"aside-top",{},void 0,!0)]),"aside-bottom":v(()=>[d(u.$slots,"aside-bottom",{},void 0,!0)]),"aside-outline-before":v(()=>[d(u.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":v(()=>[d(u.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":v(()=>[d(u.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":v(()=>[d(u.$slots,"aside-ads-after",{},void 0,!0)]),_:3}),y(Rs),d(u.$slots,"layout-bottom",{},void 0,!0)],2)):(r(),S(_,{key:1}))}}}),$r=L(br,[["__scopeId","data-v-5d98c3a5"]]),Ke={Layout:$r,enhanceApp:({app:e})=>{e.component("Badge",At)}},yr=k({__name:"HighlightTargetedHeading",setup(e){function t(){if(!window||!window.location||!window.location.hash)return;const s=decodeURIComponent(window.location.hash);if(!s)return;let o;try{o=document.querySelector(s)}catch(a){console.error(a);return}o&&(o.classList.contains("VPNolebaseHighlightTargetedHeading")||o.classList.add("VPNolebaseHighlightTargetedHeading"),o.classList.remove("VPNolebaseHighlightTargetedHeadingAnimated"),setTimeout(()=>{o&&o.classList.add("VPNolebaseHighlightTargetedHeadingAnimated")},10))}const n=ie();return te(t),X(n,async()=>{await Ae(),t()}),Mt("hashchange",t),(s,o)=>d(s.$slots,"default")}}),Vr={...Ke,Layout:()=>je(Ke.Layout,null,{"layout-top":()=>[je(yr)]})};export{Vr as R}; diff --git a/assets/chunks/virtual_search-data.B6rXHXE7.js b/assets/chunks/virtual_search-data.CaVNr-Kv.js similarity index 59% rename from assets/chunks/virtual_search-data.B6rXHXE7.js rename to assets/chunks/virtual_search-data.CaVNr-Kv.js index 6a4ceef5..ff139efa 100644 --- a/assets/chunks/virtual_search-data.B6rXHXE7.js +++ b/assets/chunks/virtual_search-data.CaVNr-Kv.js @@ -1 +1 @@ -const e={map:"[{},{},{},{},{},{},{},{},{}]"},t={},a={previewLength:62,buttonLabel:"Search",placeholder:"Search website",allow:[{},{}],ignore:[]},o={INDEX_DATA:e,PREVIEW_LOOKUP:t,Options:a};export{o as default}; +const e={map:"[{},{},{},{},{},{},{},{},{}]"},t={},a={previewLength:62,buttonLabel:"Search",placeholder:"Search website",allow:[{},{},{}],ignore:[]},o={INDEX_DATA:e,PREVIEW_LOOKUP:t,Options:a};export{o as default}; diff --git a/changelog/atom b/changelog/atom index c75dd161..95a3daed 100644 --- a/changelog/atom +++ b/changelog/atom @@ -2,7 +2,7 @@ https://www.thepaperpilot.org/changelog/ The Paper Pilot's Digital Garden Changelog - 2024-06-11T12:56:44.909Z + 2024-06-11T13:15:18.319Z https://github.com/jpmonette/feed The Paper Pilot @@ -13,26 +13,6 @@ A feed of updates made to my digital garden! All rights reserved 2024, The Paper Pilot - - <![CDATA[ 3 files changed, 48 insertions(+), 38 deletions(-)]]> - https://code.incremental.social/thepaperpilot/pages/commit/f55b76ee790425e33432c56e398c1d76f8e2e1a6 - - 2024-06-06T00:00:00.000Z - - - - -Page -Changes - - - -digital-gardens2 +- -fedi-v23 +- -the-small-web81 +++++++++++++++++++++++++++--------------------- - -]]> - <![CDATA[ 4 files changed, 72 insertions(+)]]> https://code.incremental.social/thepaperpilot/pages/commit/de7fbf829b37d635a3f143abffcc3597135a445a @@ -55,11 +35,11 @@ ]]> - <![CDATA[ 1 file changed, 11 insertions(+), 3 deletions(-)]]> - https://code.incremental.social/thepaperpilot/pages/commit/305386d2f186225a929ee2dfc275569a77a29945 - - 2024-06-09T00:00:00.000Z - + <![CDATA[ 3 files changed, 48 insertions(+), 38 deletions(-)]]> + https://code.incremental.social/thepaperpilot/pages/commit/f55b76ee790425e33432c56e398c1d76f8e2e1a6 + + 2024-06-06T00:00:00.000Z + @@ -68,7 +48,73 @@ -the-small-web14 +++++++++++--- +digital-gardens2 +- +fedi-v23 +- +the-small-web81 +++++++++++++++++++++++++++--------------------- + +]]> + + + <![CDATA[ 47 files changed, 1226 insertions(+)]]> + https://code.incremental.social/thepaperpilot/pages/commit/fe175090d3fc0cfa81754ec5b19a184005e31d8c + + 2024-06-03T00:00:00.000Z + + + + +Page +Changes + + + +activitypub13 ++ +advent-incremental21 +++ +atproto18 +++ +babble-buds22 ++++ +capture-the-citadel15 +++ +chat-glue12 ++ +chronological21 +++ +cinny10 ++ +commune33 +++++ +decentralized28 ++++ +dice-armor55 ++++++++ +digital-gardens20 +++ +federated-identity23 ++++ +fedi-v295 ++++++++++++++ +fediverse21 +++ +forgejo10 ++ +freeform-vs-chronological-dichotomy10 ++ +freeform17 +++ +game-dev-tree17 +++ +garden-rss22 ++++ +.../appeal-to-developers30 +++++ +guide-to-incrementals/appeal-to-players60 +++++++++ +guide-to-incrementals/defining-the-genre141 +++++++++++++++++++++ +guide-to-incrementals27 ++++ +.../navigating-criticism26 ++++ +guide-to-incrementals/what-is-content52 ++++++++ +incremental-social16 +++ +kronos18 +++ +logseq10 ++ +matrix10 ++ +mbin12 ++ +my-personal-website10 ++ +my-projects27 ++++ +nostr13 ++ +open-source12 ++ +opti-speech37 ++++++ +planar-pioneers15 +++ +profectus24 ++++ +social-media25 ++++ +synapse10 ++ +the-cozy-web16 +++ +the-small-web58 +++++++++ +this-knowledge-hub22 ++++ +v-ecs25 ++++ +vitepress10 ++ +webrings25 ++++ +weird12 ++ ]]> @@ -137,11 +183,11 @@ ]]> - <![CDATA[ 47 files changed, 1226 insertions(+)]]> - https://code.incremental.social/thepaperpilot/pages/commit/fe175090d3fc0cfa81754ec5b19a184005e31d8c - - 2024-06-03T00:00:00.000Z - + <![CDATA[ 1 file changed, 11 insertions(+), 3 deletions(-)]]> + https://code.incremental.social/thepaperpilot/pages/commit/305386d2f186225a929ee2dfc275569a77a29945 + + 2024-06-09T00:00:00.000Z + @@ -150,53 +196,7 @@ -activitypub13 ++ -advent-incremental21 +++ -atproto18 +++ -babble-buds22 ++++ -capture-the-citadel15 +++ -chat-glue12 ++ -chronological21 +++ -cinny10 ++ -commune33 +++++ -decentralized28 ++++ -dice-armor55 ++++++++ -digital-gardens20 +++ -federated-identity23 ++++ -fedi-v295 ++++++++++++++ -fediverse21 +++ -forgejo10 ++ -freeform-vs-chronological-dichotomy10 ++ -freeform17 +++ -game-dev-tree17 +++ -garden-rss22 ++++ -.../appeal-to-developers30 +++++ -guide-to-incrementals/appeal-to-players60 +++++++++ -guide-to-incrementals/defining-the-genre141 +++++++++++++++++++++ -guide-to-incrementals27 ++++ -.../navigating-criticism26 ++++ -guide-to-incrementals/what-is-content52 ++++++++ -incremental-social16 +++ -kronos18 +++ -logseq10 ++ -matrix10 ++ -mbin12 ++ -my-personal-website10 ++ -my-projects27 ++++ -nostr13 ++ -open-source12 ++ -opti-speech37 ++++++ -planar-pioneers15 +++ -profectus24 ++++ -social-media25 ++++ -synapse10 ++ -the-cozy-web16 +++ -the-small-web58 +++++++++ -this-knowledge-hub22 ++++ -v-ecs25 ++++ -vitepress10 ++ -webrings25 ++++ -weird12 ++ +the-small-web14 +++++++++++--- ]]> diff --git a/changelog/index.html b/changelog/index.html index 0deac72d..ab48da0c 100644 --- a/changelog/index.html +++ b/changelog/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Changelog

This feed starts when I formatted the site to be a Digital Garden. If you'd like to look further into this site's history, check here!

47 files changed, 124 insertions(+), 13 deletions(-)

Pushed on
PageChanges
activitypub2 ++
advent-incremental2 ++
atproto2 ++
babble-buds2 ++
capture-the-citadel2 ++
chat-glue2 ++
chronological2 ++
cinny2 ++
commune2 ++
decentralized2 ++
dice-armor2 ++
digital-gardens2 ++
federated-identity2 ++
fedi-v230 +++++++++++++++++-----
fediverse2 ++
forgejo2 ++
freeform-vs-chronological-dichotomy2 ++
freeform2 ++
game-dev-tree2 ++
garden-rss4 ++-
.../appeal-to-developers2 ++
guide-to-incrementals/appeal-to-players6 +++--
guide-to-incrementals/defining-the-genre6 +++--
guide-to-incrementals2 ++
.../navigating-criticism2 ++
guide-to-incrementals/what-is-content4 ++-
incremental-social2 ++
kronos2 ++
logseq2 ++
matrix2 ++
mbin2 ++
my-personal-website2 ++
my-projects2 ++
nostr2 ++
open-source2 ++
opti-speech2 ++
planar-pioneers2 ++
profectus4 ++-
social-media2 ++
synapse2 ++
the-cozy-web2 ++
the-small-web2 ++
this-knowledge-hub3 +++
v-ecs2 ++
vitepress2 ++
webrings2 ++
weird2 ++

47 files changed, 1226 insertions(+)

Pushed on
PageChanges
activitypub13 ++
advent-incremental21 +++
atproto18 +++
babble-buds22 ++++
capture-the-citadel15 +++
chat-glue12 ++
chronological21 +++
cinny10 ++
commune33 +++++
decentralized28 ++++
dice-armor55 ++++++++
digital-gardens20 +++
federated-identity23 ++++
fedi-v295 ++++++++++++++
fediverse21 +++
forgejo10 ++
freeform-vs-chronological-dichotomy10 ++
freeform17 +++
game-dev-tree17 +++
garden-rss22 ++++
.../appeal-to-developers30 +++++
guide-to-incrementals/appeal-to-players60 +++++++++
guide-to-incrementals/defining-the-genre141 +++++++++++++++++++++
guide-to-incrementals27 ++++
.../navigating-criticism26 ++++
guide-to-incrementals/what-is-content52 ++++++++
incremental-social16 +++
kronos18 +++
logseq10 ++
matrix10 ++
mbin12 ++
my-personal-website10 ++
my-projects27 ++++
nostr13 ++
open-source12 ++
opti-speech37 ++++++
planar-pioneers15 +++
profectus24 ++++
social-media25 ++++
synapse10 ++
the-cozy-web16 +++
the-small-web58 +++++++++
this-knowledge-hub22 ++++
v-ecs25 ++++
vitepress10 ++
webrings25 ++++
weird12 ++

- + \ No newline at end of file diff --git a/changelog/json b/changelog/json index 2de9b23d..ec7cb652 100644 --- a/changelog/json +++ b/changelog/json @@ -9,14 +9,6 @@ "url": "https://www.thepaperpilot.org/" }, "items": [ - { - "id": "https://code.incremental.social/thepaperpilot/pages/commit/f55b76ee790425e33432c56e398c1d76f8e2e1a6", - "content_html": "\n\n\n\n\n\n\n\n\n\n\n\n
PageChanges
digital-gardens2 +-
fedi-v23 +-
the-small-web81 +++++++++++++++++++++++++++---------------------
", - "url": "https://code.incremental.social/thepaperpilot/pages/commit/f55b76ee790425e33432c56e398c1d76f8e2e1a6", - "title": " 3 files changed, 48 insertions(+), 38 deletions(-)", - "summary": " 3 files changed, 48 insertions(+), 38 deletions(-)", - "date_modified": "2024-06-06T00:00:00.000Z" - }, { "id": "https://code.incremental.social/thepaperpilot/pages/commit/de7fbf829b37d635a3f143abffcc3597135a445a", "content_html": "\n\n\n\n\n\n\n\n\n\n\n\n\n
PageChanges
davey-wreden22 ++++++++++++++++++++++
ivy-road15 +++++++++++++++
the-beginner-s-guide22 ++++++++++++++++++++++
wanderstop13 +++++++++++++
", @@ -26,12 +18,20 @@ "date_modified": "2024-06-09T00:00:00.000Z" }, { - "id": "https://code.incremental.social/thepaperpilot/pages/commit/305386d2f186225a929ee2dfc275569a77a29945", - "content_html": "\n\n\n\n\n\n\n\n\n\n
PageChanges
the-small-web14 +++++++++++---
", - "url": "https://code.incremental.social/thepaperpilot/pages/commit/305386d2f186225a929ee2dfc275569a77a29945", - "title": " 1 file changed, 11 insertions(+), 3 deletions(-)", - "summary": " 1 file changed, 11 insertions(+), 3 deletions(-)", - "date_modified": "2024-06-09T00:00:00.000Z" + "id": "https://code.incremental.social/thepaperpilot/pages/commit/f55b76ee790425e33432c56e398c1d76f8e2e1a6", + "content_html": "\n\n\n\n\n\n\n\n\n\n\n\n
PageChanges
digital-gardens2 +-
fedi-v23 +-
the-small-web81 +++++++++++++++++++++++++++---------------------
", + "url": "https://code.incremental.social/thepaperpilot/pages/commit/f55b76ee790425e33432c56e398c1d76f8e2e1a6", + "title": " 3 files changed, 48 insertions(+), 38 deletions(-)", + "summary": " 3 files changed, 48 insertions(+), 38 deletions(-)", + "date_modified": "2024-06-06T00:00:00.000Z" + }, + { + "id": "https://code.incremental.social/thepaperpilot/pages/commit/fe175090d3fc0cfa81754ec5b19a184005e31d8c", + "content_html": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
PageChanges
activitypub13 ++
advent-incremental21 +++
atproto18 +++
babble-buds22 ++++
capture-the-citadel15 +++
chat-glue12 ++
chronological21 +++
cinny10 ++
commune33 +++++
decentralized28 ++++
dice-armor55 ++++++++
digital-gardens20 +++
federated-identity23 ++++
fedi-v295 ++++++++++++++
fediverse21 +++
forgejo10 ++
freeform-vs-chronological-dichotomy10 ++
freeform17 +++
game-dev-tree17 +++
garden-rss22 ++++
.../appeal-to-developers30 +++++
guide-to-incrementals/appeal-to-players60 +++++++++
guide-to-incrementals/defining-the-genre141 +++++++++++++++++++++
guide-to-incrementals27 ++++
.../navigating-criticism26 ++++
guide-to-incrementals/what-is-content52 ++++++++
incremental-social16 +++
kronos18 +++
logseq10 ++
matrix10 ++
mbin12 ++
my-personal-website10 ++
my-projects27 ++++
nostr13 ++
open-source12 ++
opti-speech37 ++++++
planar-pioneers15 +++
profectus24 ++++
social-media25 ++++
synapse10 ++
the-cozy-web16 +++
the-small-web58 +++++++++
this-knowledge-hub22 ++++
v-ecs25 ++++
vitepress10 ++
webrings25 ++++
weird12 ++
", + "url": "https://code.incremental.social/thepaperpilot/pages/commit/fe175090d3fc0cfa81754ec5b19a184005e31d8c", + "title": " 47 files changed, 1226 insertions(+)", + "summary": " 47 files changed, 1226 insertions(+)", + "date_modified": "2024-06-03T00:00:00.000Z" }, { "id": "https://code.incremental.social/thepaperpilot/pages/commit/91e757f7ccbeb570d900aaa5b49e6e4874d19b2f", @@ -42,12 +42,12 @@ "date_modified": "2024-06-05T00:00:00.000Z" }, { - "id": "https://code.incremental.social/thepaperpilot/pages/commit/fe175090d3fc0cfa81754ec5b19a184005e31d8c", - "content_html": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
PageChanges
activitypub13 ++
advent-incremental21 +++
atproto18 +++
babble-buds22 ++++
capture-the-citadel15 +++
chat-glue12 ++
chronological21 +++
cinny10 ++
commune33 +++++
decentralized28 ++++
dice-armor55 ++++++++
digital-gardens20 +++
federated-identity23 ++++
fedi-v295 ++++++++++++++
fediverse21 +++
forgejo10 ++
freeform-vs-chronological-dichotomy10 ++
freeform17 +++
game-dev-tree17 +++
garden-rss22 ++++
.../appeal-to-developers30 +++++
guide-to-incrementals/appeal-to-players60 +++++++++
guide-to-incrementals/defining-the-genre141 +++++++++++++++++++++
guide-to-incrementals27 ++++
.../navigating-criticism26 ++++
guide-to-incrementals/what-is-content52 ++++++++
incremental-social16 +++
kronos18 +++
logseq10 ++
matrix10 ++
mbin12 ++
my-personal-website10 ++
my-projects27 ++++
nostr13 ++
open-source12 ++
opti-speech37 ++++++
planar-pioneers15 +++
profectus24 ++++
social-media25 ++++
synapse10 ++
the-cozy-web16 +++
the-small-web58 +++++++++
this-knowledge-hub22 ++++
v-ecs25 ++++
vitepress10 ++
webrings25 ++++
weird12 ++
", - "url": "https://code.incremental.social/thepaperpilot/pages/commit/fe175090d3fc0cfa81754ec5b19a184005e31d8c", - "title": " 47 files changed, 1226 insertions(+)", - "summary": " 47 files changed, 1226 insertions(+)", - "date_modified": "2024-06-03T00:00:00.000Z" + "id": "https://code.incremental.social/thepaperpilot/pages/commit/305386d2f186225a929ee2dfc275569a77a29945", + "content_html": "\n\n\n\n\n\n\n\n\n\n
PageChanges
the-small-web14 +++++++++++---
", + "url": "https://code.incremental.social/thepaperpilot/pages/commit/305386d2f186225a929ee2dfc275569a77a29945", + "title": " 1 file changed, 11 insertions(+), 3 deletions(-)", + "summary": " 1 file changed, 11 insertions(+), 3 deletions(-)", + "date_modified": "2024-06-09T00:00:00.000Z" } ] } \ No newline at end of file diff --git a/changelog/rss b/changelog/rss index 198b8acf..58eaf56e 100644 --- a/changelog/rss +++ b/changelog/rss @@ -4,32 +4,12 @@ The Paper Pilot's Digital Garden Changelog https://www.thepaperpilot.org/changelog/ A feed of updates made to my digital garden! - Tue, 11 Jun 2024 12:56:44 GMT + Tue, 11 Jun 2024 13:15:18 GMT https://validator.w3.org/feed/docs/rss2.html https://github.com/jpmonette/feed en All rights reserved 2024, The Paper Pilot - - <![CDATA[ 3 files changed, 48 insertions(+), 38 deletions(-)]]> - https://code.incremental.social/thepaperpilot/pages/commit/f55b76ee790425e33432c56e398c1d76f8e2e1a6 - https://code.incremental.social/thepaperpilot/pages/commit/f55b76ee790425e33432c56e398c1d76f8e2e1a6 - Thu, 06 Jun 2024 00:00:00 GMT - - - - -Page -Changes - - - -digital-gardens2 +- -fedi-v23 +- -the-small-web81 +++++++++++++++++++++++++++--------------------- - -]]> - <![CDATA[ 4 files changed, 72 insertions(+)]]> https://code.incremental.social/thepaperpilot/pages/commit/de7fbf829b37d635a3f143abffcc3597135a445a @@ -52,11 +32,11 @@ ]]> - <![CDATA[ 1 file changed, 11 insertions(+), 3 deletions(-)]]> - https://code.incremental.social/thepaperpilot/pages/commit/305386d2f186225a929ee2dfc275569a77a29945 - https://code.incremental.social/thepaperpilot/pages/commit/305386d2f186225a929ee2dfc275569a77a29945 - Sun, 09 Jun 2024 00:00:00 GMT - + <![CDATA[ 3 files changed, 48 insertions(+), 38 deletions(-)]]> + https://code.incremental.social/thepaperpilot/pages/commit/f55b76ee790425e33432c56e398c1d76f8e2e1a6 + https://code.incremental.social/thepaperpilot/pages/commit/f55b76ee790425e33432c56e398c1d76f8e2e1a6 + Thu, 06 Jun 2024 00:00:00 GMT + @@ -65,7 +45,73 @@ -the-small-web14 +++++++++++--- +digital-gardens2 +- +fedi-v23 +- +the-small-web81 +++++++++++++++++++++++++++--------------------- + +]]> + + + <![CDATA[ 47 files changed, 1226 insertions(+)]]> + https://code.incremental.social/thepaperpilot/pages/commit/fe175090d3fc0cfa81754ec5b19a184005e31d8c + https://code.incremental.social/thepaperpilot/pages/commit/fe175090d3fc0cfa81754ec5b19a184005e31d8c + Mon, 03 Jun 2024 00:00:00 GMT + + + + +Page +Changes + + + +activitypub13 ++ +advent-incremental21 +++ +atproto18 +++ +babble-buds22 ++++ +capture-the-citadel15 +++ +chat-glue12 ++ +chronological21 +++ +cinny10 ++ +commune33 +++++ +decentralized28 ++++ +dice-armor55 ++++++++ +digital-gardens20 +++ +federated-identity23 ++++ +fedi-v295 ++++++++++++++ +fediverse21 +++ +forgejo10 ++ +freeform-vs-chronological-dichotomy10 ++ +freeform17 +++ +game-dev-tree17 +++ +garden-rss22 ++++ +.../appeal-to-developers30 +++++ +guide-to-incrementals/appeal-to-players60 +++++++++ +guide-to-incrementals/defining-the-genre141 +++++++++++++++++++++ +guide-to-incrementals27 ++++ +.../navigating-criticism26 ++++ +guide-to-incrementals/what-is-content52 ++++++++ +incremental-social16 +++ +kronos18 +++ +logseq10 ++ +matrix10 ++ +mbin12 ++ +my-personal-website10 ++ +my-projects27 ++++ +nostr13 ++ +open-source12 ++ +opti-speech37 ++++++ +planar-pioneers15 +++ +profectus24 ++++ +social-media25 ++++ +synapse10 ++ +the-cozy-web16 +++ +the-small-web58 +++++++++ +this-knowledge-hub22 ++++ +v-ecs25 ++++ +vitepress10 ++ +webrings25 ++++ +weird12 ++ ]]> @@ -134,11 +180,11 @@ ]]> - <![CDATA[ 47 files changed, 1226 insertions(+)]]> - https://code.incremental.social/thepaperpilot/pages/commit/fe175090d3fc0cfa81754ec5b19a184005e31d8c - https://code.incremental.social/thepaperpilot/pages/commit/fe175090d3fc0cfa81754ec5b19a184005e31d8c - Mon, 03 Jun 2024 00:00:00 GMT - + <![CDATA[ 1 file changed, 11 insertions(+), 3 deletions(-)]]> + https://code.incremental.social/thepaperpilot/pages/commit/305386d2f186225a929ee2dfc275569a77a29945 + https://code.incremental.social/thepaperpilot/pages/commit/305386d2f186225a929ee2dfc275569a77a29945 + Sun, 09 Jun 2024 00:00:00 GMT + @@ -147,53 +193,7 @@ -activitypub13 ++ -advent-incremental21 +++ -atproto18 +++ -babble-buds22 ++++ -capture-the-citadel15 +++ -chat-glue12 ++ -chronological21 +++ -cinny10 ++ -commune33 +++++ -decentralized28 ++++ -dice-armor55 ++++++++ -digital-gardens20 +++ -federated-identity23 ++++ -fedi-v295 ++++++++++++++ -fediverse21 +++ -forgejo10 ++ -freeform-vs-chronological-dichotomy10 ++ -freeform17 +++ -game-dev-tree17 +++ -garden-rss22 ++++ -.../appeal-to-developers30 +++++ -guide-to-incrementals/appeal-to-players60 +++++++++ -guide-to-incrementals/defining-the-genre141 +++++++++++++++++++++ -guide-to-incrementals27 ++++ -.../navigating-criticism26 ++++ -guide-to-incrementals/what-is-content52 ++++++++ -incremental-social16 +++ -kronos18 +++ -logseq10 ++ -matrix10 ++ -mbin12 ++ -my-personal-website10 ++ -my-projects27 ++++ -nostr13 ++ -open-source12 ++ -opti-speech37 ++++++ -planar-pioneers15 +++ -profectus24 ++++ -social-media25 ++++ -synapse10 ++ -the-cozy-web16 +++ -the-small-web58 +++++++++ -this-knowledge-hub22 ++++ -v-ecs25 ++++ -vitepress10 ++ -webrings25 ++++ -weird12 ++ +the-small-web14 +++++++++++--- ]]> diff --git a/garden/activitypub/index.html b/garden/activitypub/index.html index 9c396450..c2877f8d 100644 --- a/garden/activitypub/index.html +++ b/garden/activitypub/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

ActivityPub ​

Referenced by: Fediverse

Tags: Decentralized

ActivityPub is a protocol for Federated Social Media

Last updated:

- + \ No newline at end of file diff --git a/garden/advent-incremental/index.html b/garden/advent-incremental/index.html index 8ae22212..04e9634a 100644 --- a/garden/advent-incremental/index.html +++ b/garden/advent-incremental/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Advent Incremental ​

Tags: My Projects, Profectus

Play it here!

An Open Source game made in Profectus over the course of 1 month by myself and other devs I know in the Incremental Games community!

I had the idea of an advent-style game that unlocked new pieces of content every real-life day a couple days before December started.

This was one of the most hectic months of my life!

I'm super happy with how it turned out. It ended up being way more ambitious than I anticipated but the end result is super large and awesome!

The TV Tropes page on this game mentions some of the cool things about this game

Last updated:

- + \ No newline at end of file diff --git a/garden/atproto/index.html b/garden/atproto/index.html index db6a997c..bc1a2b10 100644 --- a/garden/atproto/index.html +++ b/garden/atproto/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

ATProto ​

Referenced by: Fediverse

Tags: Decentralized

The AT Protocol is a protocol for Federated Social Media

Currently only used by Bluesky

In comparison to other Fediverse protocols, ATProto is designed for a small number of large instances

Last updated:

- + \ No newline at end of file diff --git a/garden/babble-buds/index.html b/garden/babble-buds/index.html index f8eb8529..4751864a 100644 --- a/garden/babble-buds/index.html +++ b/garden/babble-buds/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Babble Buds ​

Tags: My Projects

Babble Buds is a tool for creating puppets and interacting with puppets controlled by others on a shared stage

Note: I need to move the website off replit because of their monetization strategy changing. In the meantime, you can check it out from its github repository

Inspired by Puppet Pals by Robert Moran

Intended for use in RPG Campaigns

The renderer was separated into its own project, babble.js, so it could be used for stuff like cutscenes

I ported the engine to C# and used it for the cutscenes in Dice Armor

  • I don't believe I ever separated it out into its own project, but you can find the code here

Last updated:

- + \ No newline at end of file diff --git a/garden/capture-the-citadel/index.html b/garden/capture-the-citadel/index.html index 34f87b04..8cb47e85 100644 --- a/garden/capture-the-citadel/index.html +++ b/garden/capture-the-citadel/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Capture the Citadel ​

Tags: My Projects

A 3D VR re-envisioning of a Slay the Spire-style game by Anthony Lawn and Grant Barbee for their VR class in college's final project.

For more details, visit Grant's page on the game.

screenshot.png

Last updated:

- + \ No newline at end of file diff --git a/garden/chat-glue/index.html b/garden/chat-glue/index.html index 8467f5c3..a162eff8 100644 --- a/garden/chat-glue/index.html +++ b/garden/chat-glue/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Chat Glue ​

Referenced by: Commune, My Personal Website, The Small Web

A theoretical chat system designed to solve the problems of transcribing branching conversations into linear timelines.

Defined by the Chatting with Glue comic.

Last updated:

- + \ No newline at end of file diff --git a/garden/chronological/index.html b/garden/chronological/index.html index ca438327..31d010d4 100644 --- a/garden/chronological/index.html +++ b/garden/chronological/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Chronological ​

Referenced by: Digital Gardens, Freeform vs Chronological Dichotomy, The Small Web

A collection of information that is tied to its creation or edit date

Part of the Freeform vs Chronological Dichotomy

Anything with a "timeline" or "feed" is considered chronological

  • Even if there's algorithmic sortings that take things other than creation or edit date into account!

Chronological displays are less suitable as stores of knowledge (Digital Gardens)

Social media overuses timelines and feeds

RSS feeds work really well with this form of content

Last updated:

- + \ No newline at end of file diff --git a/garden/cinny/index.html b/garden/cinny/index.html index 463bfc6b..4549020d 100644 --- a/garden/cinny/index.html +++ b/garden/cinny/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Cinny ​

Referenced by: Incremental Social

Cinny is an Open Source web client for the Matrix messaging protocol

Last updated:

- + \ No newline at end of file diff --git a/garden/commune/index.html b/garden/commune/index.html index 1e1ba136..a558af12 100644 --- a/garden/commune/index.html +++ b/garden/commune/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Commune ​

Referenced by: Federated Identity, Fedi v2, My Personal Website, Webrings, Weird

An Open Source Matrix web client built to be better for communities than anything else out there

  • Currently in development
  • Exposes certain channels such that they are web indexable
  • Will include features like Chat Glue and communal Digital Gardens

Created by Erlend Sogge Heggen, a ex-employee from Discourse

  • Maintains the Commune Blog with great write ups on the issues of the modern web, social media, etc. and how they can be improved (by Commune or related projects)
  • Also maintains a Personal Blog about similar topics

The Commune community is very interested in various topics and how they can relate together:

Related projects:

  • @laxla@tech.lgbt is creating Gimli, a federated discord alternative
    • Built on ActivityPub
    • "Guild-based" in ways matrix is not?
    • Will integrate with F3 as well
    • Wants to handle blogging as well
    • Certainly seems similar to Commune's message gardening concept

Last updated:

- + \ No newline at end of file diff --git a/garden/davey-wreden/index.html b/garden/davey-wreden/index.html index 0faff933..0b2ecc6a 100644 --- a/garden/davey-wreden/index.html +++ b/garden/davey-wreden/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@
- + \ No newline at end of file diff --git a/garden/decentralized/index.html b/garden/decentralized/index.html index 8e617acb..442baf3b 100644 --- a/garden/decentralized/index.html +++ b/garden/decentralized/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Decentralized ​

Referenced by: Commune, Fedi v2, Matrix, Social Media

Tagged by: ATProto, ActivityPub, Federated Identity, Fediverse, Nostr

Something with no central source of authority

Common examples:

In practice, the "pick a server" problem causes email and the fediverse to trend towards a handful of large servers that still suffer from some of the issues of centralization

Advantages over centralization:

  • Data ownership
  • Increased privacy
  • No rules to follow
  • Can fully customize your experience
  • No single entity can make the experience worse for everyone
  • Anyone and everyone can try their hand at improving the ecosystem

Last updated:

- + \ No newline at end of file diff --git a/garden/dice-armor/index.html b/garden/dice-armor/index.html index ad811470..34b2e04c 100644 --- a/garden/dice-armor/index.html +++ b/garden/dice-armor/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Dice Armor ​

Referenced by: Babble Buds

Tags: My Projects

Download it here

Dice Armor is a game that started development as a semester-long project by a team of nine: a producer, a creative director, a narrative writer, an artist, two programmers, and 3 game designers. The information here is about my contributions as the lead programmer over the semester because I can show off stuff like the editor scripts I wrote. I was doing everything from interface coding, editor scripts, integrating Babble Buds, and of course, everything related to the gameplay itself. To date I'm still the lead programmer for the game; for more up-to-date information on the current state of the game please visit the official site.

The build available here was created for showing off at the end of the semester, and as such has some buttons present to make the game easier to skip parts of the game to see all the content: You start with all the dice in the game already in the shop, there's a button to give yourself free money to buy these dice with, and in the duel, there are buttons to force a win or a loss, which can be used to skip the tutorial (not recommended for first-time players).

Tutorial

Dice Armor is a dice dueling game. Players can use abilities, flip dice, and attack each other to win in a dice game that puts chance into the hands of the players. This is what the dueling scene looks like, with a tutorial cutscene happening on top to guide the player through the basics. Also, all the dice are constructed dynamically, using quaternion math to figure out the placement of each component relative to the face it is going on. The die in the middle has one of the player' and opponents' portraits on each of its sides.

Editors

For many of the objects I've created, I've made scriptable objects so that game designers can add and modify them easily. Additionally, I would create custom inspectors for the objects to help make them as easy to understand and edit as possible. The opponent's artificial intelligence is made up of many strategies, in a prioritized list. When it is the opponents' turn they go through each strategy and check if they can be run, and if so then the opponent performs the strategy and starts back over at the top of the list of strategies. The + sign under the list of strategies opens an organized dropdown of all the various strategies.

Simulator

In addition to custom inspector code, I've created new tools for the editor for our game designers to use. This is a duel simulator that will take two opponents and simulate an arbitrary number of duels between them, and output the results and summarize them for you, much much quicker than manually going through the duels, even with an absurdly high timeScale. This will become incredibly useful in making balance changes and testing new dice against existing sets. This is a screenshot of it in edit mode, but in play mode it removes the "Dueling Managers" field and will use whatever the current duel balance settings are, allowing for the GDs to test freely in play mode without worrying about undoing all their changes afterward.

da1.png

I created the Babble Buds puppet editor and ported the rendering library I wrote for it to C# so it could be used in Unity. Dice Armor has a full campaign using cutscenes made using the Babble Buds cutscene editor, taking advantage of its support for custom commands and fields to control things like talking, giving the player dice and money, starting duels, and controlling player progression through the story.

Action Wheel

When a cutscene ends, its final command is to either start a duel or set the next cutscene in the story. In the latter case, there is an additional field for what to call the next cutscene, and what location it takes place. The cutscene is then added to the player's save file, and when they visit the city locations are greyed out until they have at least one action to do there. Each location has a dynamically populated action wheel with a custom range of acceptable angles.

Shop

The dice shop is dynamically populated by a list of dice available to the player, which can be changed during cutscenes, and is checked against the dice owned by the player to generate sold-out indicators. On the left, the player can choose to filter the options down to a single dice effect, which also updates the "Buy All" button to buy only all the dice in the current filter.

Inventory

The inventory works most the same as the shop, but for equipping dice. It also allows you to drag individual dice or entire sets to the equipped dice glyph. While dragging it will highlight all the slots the new dice will be equipped into.

Dice Rolling

The dice rolling uses the physics engine and detects once the dice have stopped moving, then determines which side is face up based on which of the normals is closest to straight up. It flags the die as cocked if that smallest angle is above a threshold. The dice sink into the table when not rolling to not interfere with any dice that are rolling.

Missile Storm

During certain events like winning the game or having the face of a die broken, the players' portraits will flash an emotion for a second. After winning, a random living die from the winning player is chosen to play their "finisher move", a flashy and dramatic effect to end the game. Shown is the arcane mechana's finisher, "Missile Storm".

After development stopped, the project became Open Source - check it out here

Last updated:

- + \ No newline at end of file diff --git a/garden/digital-gardens/index.html b/garden/digital-gardens/index.html index af2f1714..202a03c5 100644 --- a/garden/digital-gardens/index.html +++ b/garden/digital-gardens/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Digital Gardens ​

Referenced by: Chronological, Commune, Garden-RSS, The Cozy Web, The Small Web

Digital Gardens are Freeform collections of information made by an individual or community

This Knowledge Hub

Collections of digital gardens and resources for creating them:

Last updated:

- + \ No newline at end of file diff --git a/garden/federated-identity/index.html b/garden/federated-identity/index.html index 5b30e71b..d01f60dd 100644 --- a/garden/federated-identity/index.html +++ b/garden/federated-identity/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Federated Identity ​

Referenced by: Commune, Fedi v2, Weird

Tags: Decentralized

Allow for validating one's identity without relying on a specific centralized server

Implementations:

Self hosted identity providers are NOT enough to be considered federated identity

  • OIDC and OAuth require the service owner to have pre-configured with explicitly allowed identity providers

Incremental Social uses Zitadel which does NOT support IndieAuth and probably won't

Last updated:

- + \ No newline at end of file diff --git a/garden/fedi-v2/index.html b/garden/fedi-v2/index.html index 5d2b9c2c..d19013a2 100644 --- a/garden/fedi-v2/index.html +++ b/garden/fedi-v2/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Fedi v2 ​

Referenced by: Social Media

My take on a theoretical successor to federated Social Media

Inspiration ​

Weird may eventually move in the direction of implementing something like this

Identity ​

  • Federated Identity
  • Private and public keys anyone can create and store how they want
    • Fully free to create and store with no server dependencies
  • Profile information
    • Sent as a signed message through all the relays
    • How would you trust a username?
      • Petnames could be used to display human readable names via contacts or decentralized "naming hubs"
      • In most conversations online, you can trust their display name and add them as a contact as that display name
        • You only need to verify they are the same person you interacted with previously
        • You only need to trust people you want to send money to or otherwise "important identities"
        • For important identities, you can trust your contacts forming a chain of trust, or a authoritative naming hub
          • E.g. a white house ran naming hub that verifies the identities of the president and people of Congress
          • People typically wouldn't reach out to a naming hub, as it's not typically necessary
        • Contacts supercede naming hubs, so if a naming hub is breached, anyone I've previously added as a contact is still the source of truth
          • This only fails if the private key itself was breached
        • I'm just thepaperpilot, my display name. For most online communication, this is sufficient
          • My website can have a nameserver saying this publickey is the same as the site owner
          • If I write a paper at a scientific journal, they can say the author of x paper is my publickey
  • How to handle losing your private key
    • If you do have a naming hub you can verify with, they can say the identity has a new publickey
    • Contacts can "vouch" for a identity having a new publickey
    • Clients can decide to trust the new publickey based on contacts and naming hubs saying to
    • Also applies to stolen or compromised keys
  • I believe Iroh works this way

Servers ​

  • Act as relays, merely storing messages and sending them to any clients or servers that have subscribed
  • May decide to publicly display messages its received
    • These servers are how discovery would work
    • Different servers may offer unique displays, filters, etc.
  • Users can send their content to any server - no authentication or account required, as the identity suffices
    • Even replies can work this way - no need to know from where a given message originated
  • Private servers could require some password when sending messages or subscribing to things
    • Useful for a school or other entity that wants an internal social network
  • Different ways to subscribe to a server's messages
    • All messages the relay hears about (new relays essentially subscribe like this to some existing relay)
    • All messages from a specific poster ID
    • Any replies to a message created with a specific poster ID
    • Shallow subscriptions, to lighten the load when subscribing to communities

Content ​

  • Protocol should dictate how to convey text, image, audio, video, and binary content
  • Protocol should include reacting to content with arbitrary text, including a URL
    • Upvotes and downvotes are implemented with this system
  • Each message contains fields for the poster's ID (public key) and a signature that verifies the content was made by that poster
    • That signature serves as an ID for the message itself
      • Anything can be replied to using the ID as the "parent" property in a new post
  • Edits are handled as replies with some flag to indicate it's updating the parent messages' content
    • Naturally, this reply would only be respected if it matches the same creator ID
    • Servers should replace the original message entirely with this one and indicate its an edited message
      • Some servers will inevitably keep a full history though
  • Groups/communities are just specially flagged messages
    • Posting to a community is just replying to that message
    • Subscribing to a community is just subscribing to that message
    • The original message creator effectively owns the group

Moderation ​

  • In general, edits and delete requests are made by replying with a specially flagged message
  • Edit and deletion messages are ignored unless they have the correct public key and signature
    • Parent messages form a hierarchy of permission - if someone replies to your message, you can send a delete request for that message
    • Relay owners cannot fully delete messages, but can choose to stop relaying replies etc. of messages as the server owner wishes
  • Posts can be publicly reported with a specially flagged reply
    • How to make anonymous reports?
  • Users can send deletion or edit messages even without a matching public key, and clients (or relays) can choose to respect those messages if that public key is whitelisted as a moderator
    • Messages (and by extension, groups) can have replies granting or removing permission to other public IDs at that hierarchy level
    • People can setup accounts with their desired heuristic for sending delete messages, such as looking at public reports or analyzing the content with AI
      • This way clients can effectively customize their preferred moderation
  • Clients can also choose to add additional rules for hiding content, such as any reports by followed users
  • Perhaps delete messages pull double duty as public reports in and of themselves?

Problems to solve ​

  • No anonymity
    • All upvotes, downvotes, etc. are linked to your public key
    • Perhaps a client could generate new keypairs for every action for anonymity, but then it'd be hard to determine if such an account and action was a genuine user or a bot
  • Servers could probably determine the identity of clients sending their messages to them
    • A client that only ever sends messages with a specific public key is unlikely to be a server
    • A client that doesn't subscribe to all messages is unlikely to be a server
  • Illegal material will likely be placed on the hard drive at least temporarily
    • Messages will be downloaded and, even if you follow a moderator bot that looks for illegal material, there's likely to be a delay between receiving the initial message and receiving the bots delete message
  • You have to download all spam messages
    • For redundancy, you'd likely subscribe to multiple relay servers
    • You cannot trust several relay servers to have identical rules on not relaying messages that don't pass whatever moderation heuristic
    • Therefore, the filtering out of spam has to be done by the client, after downloading it all

Last updated:

- + \ No newline at end of file diff --git a/garden/fediverse/index.html b/garden/fediverse/index.html index 5ec4e012..4a10d70a 100644 --- a/garden/fediverse/index.html +++ b/garden/fediverse/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Fediverse ​

Referenced by: ATProto, Decentralized, Incremental Social, Mbin, Weird

Tags: Decentralized

A collection of Social Media websites that can all talk to each other by virtue of a shared protocol

Typically refers to sites implementing ActivityPub

Implementations:

Last updated:

- + \ No newline at end of file diff --git a/garden/forgejo/index.html b/garden/forgejo/index.html index 3e7f91e6..a0b55b25 100644 --- a/garden/forgejo/index.html +++ b/garden/forgejo/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Forgejo ​

Referenced by: Incremental Social

Forgejo is an Open Source code repository hosting software

Last updated:

- + \ No newline at end of file diff --git a/garden/freeform-vs-chronological-dichotomy/index.html b/garden/freeform-vs-chronological-dichotomy/index.html index dc592d5b..02ca0d7f 100644 --- a/garden/freeform-vs-chronological-dichotomy/index.html +++ b/garden/freeform-vs-chronological-dichotomy/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Freeform vs Chronological Dichotomy ​

Referenced by: Chronological, Freeform

Describes a dichotomy between displaying information in a Freeform vs Chronological manner

Last updated:

- + \ No newline at end of file diff --git a/garden/freeform/index.html b/garden/freeform/index.html index a12f0577..14daea63 100644 --- a/garden/freeform/index.html +++ b/garden/freeform/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Freeform ​

Referenced by: Commune, Digital Gardens, Freeform vs Chronological Dichotomy, Garden-RSS, The Small Web

A collection of information that is not tied to when it was created or edited

Part of the Freeform vs Chronological Dichotomy

Anything wiki-style is considered freeform

  • A collection of living documents

Garden-RSS, a theoretical alternative to RSS that's better for freeform content

Last updated:

- + \ No newline at end of file diff --git a/garden/game-dev-tree/index.html b/garden/game-dev-tree/index.html index 2a2bdbee..751b9a40 100644 --- a/garden/game-dev-tree/index.html +++ b/garden/game-dev-tree/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Game Dev Tree ​

Tags: My Projects

Play it here!

My first (good) incremental game! (My actual first was Shape Tycoon - I don't recommend it!)

It's Open Source!

The TV Tropes page on this game mentions some of the cool things about this game

Last updated:

- + \ No newline at end of file diff --git a/garden/garden-rss/index.html b/garden/garden-rss/index.html index 57c5736e..54f504cb 100644 --- a/garden/garden-rss/index.html +++ b/garden/garden-rss/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Garden-RSS ​

Referenced by: Freeform, The Small Web, This Knowledge Hub

A theoretical alternative to RSS that's better for Freeform websites (and Digital Gardens specifically )

Why is it useful?

How should it work?

  • Could display changes similar to git diffs

Existing Work

Last updated:

- + \ No newline at end of file diff --git a/garden/guide-to-incrementals/appeal-to-developers/index.html b/garden/guide-to-incrementals/appeal-to-developers/index.html index 2845dc8f..0cf9b68f 100644 --- a/garden/guide-to-incrementals/appeal-to-developers/index.html +++ b/garden/guide-to-incrementals/appeal-to-developers/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Guide to Incrementals/Appeal to Developers ​

There are a lot of developers in the incremental games community - the genre seems to draw them in, and convert a lot of players into developers. Let's explore the reasons why this genre appeals to developers.

Incrementals are Easy to Make ​

Compared to other genres, incrementals have quite low expectations. You don't need to make fancy art, or music, or lay things out nicely. If you can make a button and learn the few lines of code necessary to make a number go up, you can make an incremental. This low threshold makes the genre perfect for those who are actively learning to code and haven't developed any gamedev-related skills yet.

Additionally, unlike other genres incrementals are uniquely easy to implement in a normal web page - no need to worry about rendering sprites, moving them around, implementing physics, etc. New developers can just use HTML to add a button, and the game is now available in your browser. You don't need to choose an engine, have admin privileges, or hell for the dedicated you don't even need a computer - there are tools for web development that run in the browser itself, so you can technically use your phone if that's all you have.

Javascript is a perfectly viable language for making web games, whereas other genres are typically going to require using other more difficult languages to learn. There are countless javascript tutorials that start from 0 knowledge of programming, making it incredibly accessible to beginners.

Players are Easy to Find ​

Once you've finished your game and uploaded it on github pages or itch or just copied the link if you're using glitch or replit (all of which are easy to do), anyone can now play the game in their browser. This low barrier to entry has shown tremendous success in getting completely unknown developers to have thousands of plays.

The incremental games community, which mostly centers around r/incremental_games, is always looking for new games and tends to flood any new ones posted with initial players.

Having your games be played can be incredibly motivating, and the community makes it quite clear that you can expect players to play your game. These communities - both for incremental games in general as well as game-specific communities - tend to be very developer friendly as well. A lot of the developers know each other, and welcome new developers with open arms, often with dedicated channels for programming help and discussions.

Monetization ​

I'd like to clarify that everything I've said above mainly applies to web-based incrementals. Incremental games are also incredibly popular on mobile, but with a much different culture and community. Many mobile gamers will still participate in the web-focused community for the culture. This web-focused community has a culture that has been criticized for being "anti-monetization". Ads, IAPs, and similar forms of monetization are often criticized, mainly due to the abundance of completely non-monetized games available from hobbyist developers. There are exceptions, like paid games often being considered fine, like Increlution or Stuck in Time, or donation ware games like kittens game, but even popular games that have IAP see some level of regular criticism, like NGU Idle, Idle Skilling, or Idle Pins. A large part of this can be explained by the community being hyper-aware of the addictive) nature of this genre and its susceptibility to exploiting players.

On mobile, however, monetization is the norm and expected. If an incremental game is available on mobile, it almost certainly will be monetized, and mobile players are aware and accepting of that. Mobile incremental games, due to their addictive nature, tend to make a lot of money. It's very lucrative, and therefore these games are quite abundant on mobile storefronts.

Last updated:

- + \ No newline at end of file diff --git a/garden/guide-to-incrementals/appeal-to-players/index.html b/garden/guide-to-incrementals/appeal-to-players/index.html index a3799e87..9fdb0f6a 100644 --- a/garden/guide-to-incrementals/appeal-to-players/index.html +++ b/garden/guide-to-incrementals/appeal-to-players/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Guide to Incrementals/Appeal to Players ​

This is something that has been discussed and analyzed by many people, and to some extent, I feel like everything that can be said on the topic already has. However, a lot of these analyses are from the perspective of those with not as much experience and involvement within the genre as I'd argue would be necessary for a fully contextualized answer. I recently watched a video about Vampire Survivors, which has since been taken down due to drawing negative attention, which made me think about some interesting arguments about what games are, and what makes them good. The video's argument that "Vampire Survivors is not a video game" mirrors a claim by the developer of Cookie Clicker that his games are "non-games". Using Vampire Survivors and the video made on it as a framework, I'll be answering why incremental games appeal to players. Since the video has been taken down, I'll do my best to contextualize and generalize the arguments of the video without requiring the reader to watch it. For what it's worth, while I disagreed with the video I actually liked a lot of the way it went about thinking about games, and I consider this a continuation of that discussion.

Numbers Going Up ​

This is a very common response to why people enjoy incremental games, although it's not one I find compels me personally, and I suspect it might be a stand-in for progression) or Guide to Incrementals/What is Content?. But reportedly, some people do just like seeing big numbers. I must reiterate I suspect the actual cause is seeing big numbers in context though - if you start at 1e1000 of a currency and get to 1e1001, that isn't going to feel as satisfying as going from 1e10 to 1e100, and in any case, I don't think a button that just adds a zero to your number will feel quite satisfying - I believe its the sense of having made progress, and comparing where you are to where you started and feeling like you've earned your way here that is enjoyable.

Progression

Vampire Survivors can be argued to have a comparatively low depth to its combat compared to many other games. I'd argue it has sufficient depth and more than someone might expect who has only played the game for a short while, but it still definitely gets beat out by many other combat-focused games. Instead, a lot of the progression in Vampire Survivors comes from a meta-progression system by which base stats are increased by spending a currency that persists between runs. While it is technically possible to win without this meta-progression system, and indeed in many roguelikes players like to challenge themselves by beating the game without any meta-progression, the criticism can be made that meta-progression de-emphasizes player skill by making it less important to have to beat the game. Certainly, in incremental games, it is often literally impossible to complete a game without taking advantage of the meta-progression systems. I'd argue this does not detract from the game, however, and is actually a part of what makes incremental games, and roguelikes, enjoyable to many players: meta-progression augments the increases in skill the player is naturally gaining as they play. In effect, it's not replacing the skill increase, but exaggerating it to make it feel more real to the player.

Note: There is also a lot of progression from exploring the mechanics and discovering synergies, unlocking new weapons or playable characters, etc. That just isn't as relevant to this discussion, but it does make up a lot of the appeal of the game.

Effortlessness ​

Incremental games are so easy, a lot of them even have you progress while you're not playing! Part of the appeal is being able to feel like you're making progress while doing something actually productive - multitasking, in a way. In this sense, the game is more of a fidget toy - not something to think hard about and play actively, but something to click a few buttons every so often while you're paying attention to a lecture or studying or working. Of course, not all incremental games lend themselves to being played this way - it's specifically "idle" games that work like this. These are games that take an incredibly long amount of time to see all the content, stretching it as thin as possible, but they aren't expecting you to be sitting at your device playing it the entire time. They expect you to leave and come back later to make a bit of progress and repeat the cycle.

If you look at the higher-level play of most games, you'll see them perform difficult feats with ease and speed. They'll achieve a "flow state" that takes all their knowledge and experience of the game and uses it to play the game as instinctively as possible. It's incredible to watch things like Slay the Spire speed runs or competitive DDR-likes. I'd argue the goal of a lot of games with a competitive scene is to get so good that the game becomes effortless. In that sense, a game that allows you to reach that point earlier isn't any less legitimate, but rather lowers the barrier to entry by allowing more people to get "really good" at the game. And to be clear, Vampire Survivors and (most) incremental games aren't trivially easy - they, and to an extent, every game will have some level of learning and improvement over time.

Addiction

A lot of these reasons for why incremental games appeal may have reminded you of why gambling appeals to people, particularly those prone to addiction. Indeed, incremental games are quite often criticized for their similarity to a skinner box. Some have gone as far as to say incremental games as a genre are commenting that all games are skinner boxes). The argument goes that some games are not fun, but rather condition players into continuing to play without actually getting anything from the experience. When tied to real-world money this is seen as predatory, and to a lesser extent, even free games may be feeding the addictive sides of people and making them more prone to seek out gambling or micro-transaction heavy games.

While incremental games can be fun and even healthy in certain contexts, they can exacerbate video game addiction more than other genres. If you feel like playing incremental games is taking priority over other things in your life, or manipulating your sleep schedule, it may be prudent to seek help. See r/StopGaming for resources.

Since incremental games are often built on extrinsic motivations in the form of progression systems, it's hard to argue whether players continue to play because they are enjoying the gameplay, or if they are just conditioned to keep doing it because the game keeps rewarding them. Unfortunately, it can often feel like it's the latter, as there isn't typically anything compelling about the "gameplay" of clicking a button and waiting. There may be a significant overlap between those who enjoy incremental games and those who are most prone to addiction, and there are often posts on r/incremental_games about someone either struggling with or overcoming video game addiction.

Strategy ​

Incremental games could be considered a subset of strategy games), and inherit the appeals of strategy games. This includes the appeal of feeling like you've found a good solution to a puzzle, or that you're learning more about the game and are improving at making decisions within it. This applies to Vampire Survivors specifically, where you're learning about evolutions and synergies and what kinds of enemies can spawn under what conditions, and how best to handle them.

Note that strategy games are not all the same difficulty, as well. Vampire Survivors is still easier to play than Starcraft 2, and Cookie Clicker is probably somewhere in between (once you progress sufficiently). Vampire Survivors being so successful may indicate that "easier" strategies may have their separate appeal to harder strategy games - players like to feel smart and that they figured the game out and have optimized or mastered it, and the game being easier doesn't detract from that sense of accomplishment as much as it allows more and more users to be able to reach the point where they gain that sense.

Avoiding Staleness ​

Incremental games tend to have "paradigm shifts", where the gameplay changes in a meaningful way at various times throughout the progression of the game. These upset and change the gameplay loop, which helps keep them from stagnating. This constant "freshness" to the gameplay can keep players engaged for longer, compared to a game with a repetitive and static gameplay loop.

Good Game Design ​

Incremental games tend to show their game design "plainly", so it's more readily apparent if a game has good game design while playing, even if you're not looking for it. While different players have different preferences and might enjoy different types of games more than others, there are underlying good and bad game design principles that players will notice the effects of. To be clear, this isn't talking about stuff like big numbers being enjoyable, where I can comfortably agree to disagree with other players. They don't intrinsically make my experience better, but I'm aware of those for whom it does and I won't argue against their feelings. However, the game designer in me does feel like there are some extremely clear-cut examples of good and bad game design philosophies.

Let's start by giving an example of a mechanic I think can be easily and strongly argued is good game design. There are of course many examples, but a personal favorite of mine is how DOOM encourages aggressive gameplay by linking health drops to melee attacks. It has an intended experience it's trying to give the player - immersing themselves as DOOM guy, who would not hide behind cover when low on health - and this mechanic does a great job at encouraging and effectively teaching players to behave properly. This is in sharp contrast to shooters like Call of Duty, which have you regen health passively, encouraging players to hide behind cover and wait after getting hit. Note that I'm not arguing CoD is poorly designed, as the games have different intended experiences. I'm specifically praising DOOM for having a mechanic that does a good job at ensuring the player has that intended experience.

To contrast with an example I think is bad game design, let's talk about shields in souls-likes. This is a bit of a famous example, and I highly recommend this video essay which spends quite a good bit of time on this topic. Essentially, the argument boils down to players of earlier games in the souls games using shields too much - playing slowly, conservatively, and ultimately having less fun. Players wanted to feel safe, so they ended up playing in a way that ruined the experience for them. The developers solved this by removing shields, apart from an intentionally bad one effectively mocking the playstyle, and it did its job at getting players to play more aggressively, and often have more fun.

To bring the conversation back to incrementals, I'm incredibly opinionated on what makes a good incremental game, which I'll discuss in the game design section. Suffice it to say, incremental games rely more on good game design than other genres, due to not having much to distract from bad game design. This helps (although imperfectly - gamers are a bit too tolerant of bad game design!) well-designed games rise to the top within the genre.

Artistic Merit ​

The Vampire Survivors video made me think back to the old arguments about whether games are art, and whether they ought to be. The video seems preoccupied with attaching value to games solely based on their mechanics and the depth thereof, to the point of arguing Vampire Survivors is a waste of time due to its lack of depth. However, even setting aside the fact that if players are having fun then it's not time wasted, I think games can have artistic merit that supersedes the necessity of having (any / engaging / "deep") gameplay. I think the consensus online is that games are definitively art, although I could see the argument that some genres, like incremental games, might be a bit in a grey area. Let's talk about Vampire Survivors first though - It has a story to tell, with lore and many characters, that drive the player and encourage them to continue exploring the game and discovering things within it. Like any walking simulator, it is no less legitimate of a game or the "art" label because of any lack perceived lack of depth. For what it's worth, most art can be consumed with more ease than VS - any painting, movie, sculpture, etc.

A lot of incrementals have a narrative context that can similarly qualify them as art. Cookie Clicker is, as has been pointed out numerous times before, commenting on excess and increasing production beyond any reasonable limits - devolving into increasing production for its own sake. Indeed, a lot of incremental games are written to comment upon various concepts like capitalism or tropes in games, as discussed when defining Incrementals). However, I'd like to argue most incremental games are still art, even without any narrative context. "Art" as a concept is pretty nebulous already, but I personally like those who define it as an act of expression more than any physical result. The creator and the context within which they created the art, and any meaning they put into it, are all relevant and a part of the art itself. Most incremental games have artistic merit from things like why the creator made it, why they chose to make it an incremental game, and why they made any particular design decision. Hell, even if you play through an entire incremental game without a single thought or feeling, that very fact it elicited nothing can itself be artistic merit!

I'm not an art major, and I may be taking a somewhat extreme take on what is art and what has artistic merit, but I'd argue the overall point stands that games, and incremental games specifically, can have artistic merit, which appeals to many gamers.

Last updated:

- + \ No newline at end of file diff --git a/garden/guide-to-incrementals/defining-the-genre/index.html b/garden/guide-to-incrementals/defining-the-genre/index.html index 6504b0a4..6fca89cd 100644 --- a/garden/guide-to-incrementals/defining-the-genre/index.html +++ b/garden/guide-to-incrementals/defining-the-genre/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Guide to Incrementals/Defining the Genre ​

Video games are placed into genres for a variety of reasons. They can give a mental shorthand to set the player's expectations up, they can help a game market itself by its similarities to other, already popular games, and honestly, people just love categorization for its own sake. For this guide, it's important to define the genre so it is clear what games it's even talking about.

This poses a problem. "Incremental" is a horribly vague way to define games. Most games have numbers going up in some form or another. We need a more specific definition - similar to how "strategy" can't just mean any game with any amount of strategy because that would be most games. What specifically differentiates incremental games from the rest?

"Incremental" implies it's a genre defined by a game mechanic, but all those game mechanics it could imply exist in many other games. Having a skill tree or upgrades doesn't make you incremental, and if a reset mechanic is all it takes then every roguelite would be an incremental as well. So clearly there's more to it than that - what makes an incremental an incremental?

I'd like to go over a couple of popular suggestions I've seen on defining the genre here. I have my personal preferences and will state them here, but I don't think there's a truly perfect answer here.

Disclaimer: I mostly play incremental games on my computer, and my definitions will be heavily biased towards the games I'm familiar with.

Incrementals vs Idlers vs Clickers ​

Oftentimes people refer to this genre as idle games and/or clicker games. You'll even find a trend of oxymoronic game titles that contain both terms. "Incremental games" is the umbrella term both those terms fall under. However, I'd like to argue that not only is it better to just use the term "incremental games", but calling them "idle games" or "clicker games" is wrong. Almost universally, these terms are used interchangeably to refer to the same kind of game, where you start the game click spamming and eventually automate the process. Frankly, that kind of game deserves neither title, and the genre of incremental games has trended away from ever requiring click spamming, as it's a bad mechanic, anyways.

While these games do span a spectrum of how active it requires you to be, and sorting games by that metric can be useful for those looking for a particular experience, the borders of when an incremental game counts as an "idler" is too blurry for the term to be useful. "Incremental games" may not be a great descriptive term for the genre (hence this many thousands of words long page on defining what the genre even is), but it's strictly better than calling them "idler" or "clicker" games. This guide will always use the term "incremental games" unless quoting someone else, as it is the term you typically see on all modern games in the genre.

Incrementals as Parodies

Let's start with one of the most interesting definitions of incremental games. Incremental games appear to be distilled versions of games or genres, "revealing" the naked game design at the core of these games or genres not unlike how parodies comment upon their source material.

To understand what that means, think of how a casino uses skinner boxes to emotionally manipulate its customers to keep playing, but "dressing" up the skinner box with tons of stimuli to hide that ultimately the goal is to condition you into coming back compulsively. The idea that incremental games are parodies means taking the stance that at some level all games are similarly manipulating you, giving dopamine rewards in a way that manipulates you to keep playing while not necessarily giving you any value or fulfillment. Incremental games, then, are any games that plainly display the skinner box, and the manipulative core of the game, at the forefront of the experience.

While incremental games can be fun and even healthy in certain contexts, they can exacerbate video game addiction more than other genres. If you feel like playing incremental games is taking priority over other things in your life, or manipulating your sleep schedule, it may be prudent to seek help. See r/StopGaming for resources.

This "undressing" tends to go hand in hand with a reduced focus on aesthetics, often just printing the game state directly to the screen as text. This makes incremental games much easier to develop, particularly for those with programming skills but not art skills, but that's a tangent for why Incremental Games Guide to Incrementals/Appeal to Developers.

Before I continue, I'd like to make my stance clear that I love games and incremental games, and do not think they should be considered inherently bad or manipulative with the above logic. Skinner boxes are just a way of manipulating behavior via rewards. The games are still fun - that's the reward! I'd believe the real criticism here is that it is "empty fun", or "empty dopamine", that doesn't offer any additional value or sense of fulfillment. I don't think that's inherently bad in moderation, although it can become a problem if the game is manipulating you for profit-seeking, or if you play the game to the detriment of the other parts of your life.

Another interpretation of incremental games as parodies comes from several mainstream incremental games that are also parodies of capitalism, such as cookie clicker and adventure capitalist. It's a very common framework for incremental games to portray the ever-increasing numbers as an insatiable hunger for resources, like the ones observed within capitalism. Therefore, these games are used as evidence that the genre as a whole is about parody and commentary.

Popular videos on incremental games that portray the genre as parodies are Why Idle games make good satire, and how it was ruined. and Bad Game Design - Clicker Games. You may also be interested in this response to the latter video from a fan of incremental games: BadGood Game Design - Clicker Games.

I think that this definition ultimately ascribes a motive to the genre as a whole that only happens to apply to some of the more mainstream titles. There certainly are incremental games commenting on different things, including the genre itself as in the case of The Prestige Tree Classic, The Ascension Tree, or Omega Layers, but certainly not all. And of course, not all games that comment on something or parody something are incremental games! Additionally, a very large majority of incremental games are mobile games using these manipulative strategies to get players to spend as much money as possible - hell, Adventure Capitalist is ostensibly a critique on capitalism but features microtransactions and gameplay that manipulates you into buying them! These profit-seeking incremental games certainly belong within the genre but are hardly parodies when they too use manipulation to serve their interests. Also, from my own anecdotal experience, those who use this definition seem to do so from a fairly surface-level familiarity with the genre, and often in the context of criticizing the genre or the fans thereof.

Incrementals as NGU ​

Another broad definition often used is that incremental games are games where the focus of the game is "numbers going up". This definition proposes that other genres simply use increasing numbers as a means to an end, but incremental games uniquely only care about the numbers themselves going up. Put another way, it implies there should be no narrative justification for the numbers going up other than "why shouldn't they be going up?"

While this definition is common because it feels easy to understand, it is difficult to formally define. Often phrases are used to describe games using this framework, such as having an "exaggerated sense of progression" or "big" numbers. These terms are vague and don't demonstrate an actual threshold between non-incrementals and incrementals. Most games have a sense of progression, so when is it "exaggerated"? How big are "big" numbers? Most notably, RPGs that are typically not considered incrementals will often pass this definition.

Additionally, a lot of incrementals tend to have some theme guiding the gameplay, or at least the names of mechanics. This makes the line blurred between when numbers are going up for their own sake versus for a contextual reason. I believe this point is best illustrated that, while most RPGs are not considered incremental games, there is a sub-genre of "incremental RPGs" that typically relates to RPGs that perform combat automatically. This definition of incremental games does not support RPGs and "incremental RPGs" being on distinct sides of the line if the only difference between them is manual vs automatic combat.

Incrementals as Strategies

This is a rarer interpretation, but there are similarities between incremental games and strategy games, implying incrementals might just be a sub-genre of strategy games. By this approach, incremental games would be defined by their relation to strategy games, and how they involve player strategy. Incremental games are often large optimization problems - above all else, the actual gameplay the player is performing is deciding what to do next. The consequences of wrong decisions are typically more lenient in incremental games - such as just not making optimal progress - but they certainly get complex.

So if we accept the premise that incrementals could fall under strategy, we still need to define what makes a strategy game an incremental versus some other strategy sub-genre. This is a bit tricky due to one particular sub-genre of strategy games: Factory Builders.

Factory builders, such as Factorio or Satisfactory, are games about gaining ever increasing resources, optimizing production, and expanding more and more. That... sounds pretty similar, doesn't it? In fact, there's been some debate on whether factory builders would fall under the "incremental" umbrella. I think it's safe to say the two are certainly related, and probably have quite a bit of overlap in playerbase.

Roguelites as Incrementals? ​

Earlier on, I mentioned reset mechanics shouldn't be used in the definition because that could make all roguelites incrementals... But what if it does? A lot of incrementals can be described as games with a strong sense of progression, often with layers of meta-progression. Roguelites fit that bill to a T. What would make roguelites not incremental? I honestly don't think there's a good explanation here, but many fans of incremental games will state they do believe the two genres to be unrelated, even if there's a significant overlap between their player bases due to having similar appealing traits.

At this point, it'd be appropriate to consider what part of the definition of roguelites precludes them from also being incrementals, but that reveals a new problem: What are roguelites? They're usually defined as rogue_likes with meta-progression, but that just pushes the problem back a step: Incrementals aren't the only genre to have difficulties defining themselves, it seems! Roguelikes are another genre where the community argues over the formal definition of their genre, although that means we can borrow from their process of coming to a consensus, and maybe come across a viable definition for incremental games.

The Berlin Interpretation ​

By far the most popular way of defining roguelikes is the "Berlin Interpretation", which acknowledged the diversity of games within the genre and argued the definition should not be based on any ideals about what the genre ought to be, but rather defined by "its canon". They argued there are a handful of games that can be used to define the canon for roguelikes, and from those games, a list of factors can be derived to determine a game's "roguelikeness". The more factors a game has, the more of a roguelike it is. This strategy is very lenient, allowing a game to not present any specific factor so long as it shows enough, and accounts for the blurriness of any genre definition by not explicitly stating how many factors a game must have to qualify as a definite roguelike.

I believe this strategy for defining genres can be applied to other genres as well. A handful of games can be argued to be the incremental games canon, and a list of factors derived from them can be used to judge any game based on its "incrementalness". I'll propose such a canon and list of factors here, but by no means should it be considered the end-all-be-all.

Note: The "Temple of the roguelike", an authority within the genre, has since replaced the Berlin Interpretation with a new set of factors here: https://blog.roguetemple.com/what-is-a-traditional-roguelike/

The Incremental Games Canon ​

Alright, time to get controversial. Up til now, I've been trying my best to stay objective and analytical, but now it's time to start making some opinionated decisions. Here is a list of games I think could justifiably make up an Incremental Games Canon:

I chose a variety of games here, biasing towards newer games, purposefully to avoid making a narrow or "traditional" definition. The genre is growing and shouldn't be constrained by the traits of the early popular titles. A lot of these could easily be replaced with other games that are mechanically congruent, so ultimately I'm sure if you asked 10 people for their canon list you'd just get 10 different answers, but I think this should sufficiently allow us to determine what factors make a game have higher "incrementalness".

The Paradigm Shift ​

The Paradigm Shift is probably the highest possible value factor for an incremental. It's so common that for a while people referred to incrementals that exhibit this trait as "unfolding" games, to the point of trying to replace the term incremental due to their popularity. Paradigm shifts refer to when the gameplay significantly changes. There are too many examples to list here, but notably, every single reset mechanic is typically going to be a paradigm shift. Examples of games with paradigm shifts that aren't tied to reset mechanics include Universal Paperclips and A Dark Room.

There are many reasons for the appeal of paradigm shifts. Oftentimes each mechanic builds on top of the existing mechanics, increasing the complexity of the game in steps so the player can follow along. They provide a sense of mystery, with the player anticipating what will happen next. They shake up the gameplay before it gets too stale - allowing the game to entertain for longer before the sense of Guide to Incrementals/What is Content? dissipates. Of the canon games selected above, I would argue every single one contains a paradigm shift (although I could see someone disagreeing with that statement wrt Increlution).

I should take a moment to say that while I'm hyping up this specific factor, we cannot just reduce the genre definition to "does it have paradigm shifts". Many games have paradigm shifts that are not incremental, so it's just an indicator of incrementalness. Additionally, it can become quite hard to determine how large of a shift is a "paradigm" shift. Take, for example, any game with a skill tree. In some games, each skill node might have a large impact on how you play with the game, and qualify as a paradigm shift for some players. In other games, each skill node might just be a small percentage modifier on some stat that doesn't really impact much more than a slight bias towards an already established mechanic that's newly buffed. Every single canon game may show that it's common amongst incremental games, but could just as easily indicate that they're common in games in general.

High-Value Factors ​

I won't take as long to discuss the high and low-value factors, as you've already seen most of them brought up earlier on this page. As a reminder, a game does NOT need all of these to be an incremental game, but these are factors that each indicate a strong possibility the game is an incremental, so having several of these means they probably are. These factors apply to most of the canon incremental games.

"Pure UI" Display. Incrementals typically have a textual presentation of the game state - there isn't a visual representation of the entities within the game. The interface is closer to what would be just the UI of a game in another genre or the control panel of a plane. If there is a visual representation, the player is often still interacting with non-diegetic game elements.

Reduced Consequences. Incrementals tend to have reduced repurcussions for misplaying. They very rarely have fail states, where often the largest consequence is simply not progressing - never losing progress.

Optimization Problems. The predominant gameplay of incrementals is typically solving optimization problems, from deciding which purchase to save up for to reasoning and deciding between different mutually exclusive options the game presents.

Resource Management. Incrementals tend to have a lot of resources within the game to keep track of.

Low-Value Factors ​

These are low-value factors, meaning they aren't as strongly correlated with incremental games. Incremental games may have none of these, and non-incrementals may have several of these - if a game only has low-value factors, they're probably not an incremental.

Fast Numeric Growth. Numbers in incremental games tend to grow faster than in other genres. There are more instances of superlinear growth. The larger the numbers get, the stronger of a signal this factor is.

Automation. As an incremental game progresses, the player often no longer has to deal with earlier mechanics, by having them either happen automatically or otherwise be replaced with an alternative that requires less player interaction.

Goal-Oriented. Incrementals are often heavily reliant on extrinsic motivation to guide the player. Typically this is through some sort of in-game goal to work towards, such as a certain amount of a resource being required to unlock or purchase something new.

Waiting is a Mechanic. In incremental games, the player may come across times where there is no action they can take, and the game will progress automatically instead. The player must wait for some amount of this automatic progress to occur before they can resume interaction with the game.

Are Roguelites Incrementals? ​

Having made our variation of the Berlin Interpretation for incremental games, we can compare it to the Berlin Interpretation to determine if there's enough overlap that any game that "passes" the Berlin Interpretation would also pass the incremental variant. That is to say, whether any roguelite would also be considered an incremental game.

The meta-progression of an incremental game could arguably be considered a paradigm shift, and certainly adds some resource management. Goal-oriented would probably also apply. I think anything other than those would be a stretch, and in my opinion that just isn't enough to qualify. To be totally honest, I was never expecting to conclude otherwise though 😉

Sub-Genres ​

There are some trends in incremental games that go beyond just being a commonly used mechanic, such that they deeply affect the rest of the game design. These trends can be used to determine sub-genres within the incremental games umbrella:

Loops games are a sub-genre defined by having a core mechanic related to a loop, where the player is deciding the actions taken per loop. Notable examples include Idle Loops, Stuck in Time, Cavernous II, and Increlution. You may also argue Groundhog Life and Progress Knight fall into this sub-genre.

ITRTG-like games are a sub-genre defined by having a core mechanic based on clearing increasingly difficult battles and often tend to have a lot of different mechanics to become progressively stronger. Notable examples include Idling to Rule the Gods, NGU Idle, and Wizard and Minion Idle.

Polynomial Growth games are a sub-genre defined by having a core mechanic related to a higher degree polynomial. Notable examples include the base layer of Antimatter Dimensions and Swarm Simulator.

Upgrades Games is a category popular on flash games websites that featured games focused on buying upgrades that would allow you to attain more currency in some sort of minigame that would earn you more money to buy more upgrades, which I'd argue now belong under the fold of incremental games. Notable examples include the Learn to Fly series and Upgrade Complete.

Cultivation RPGs are a genre of games, books, and anime popular in China that center around being in a fantasy world with characters getting stronger over time. While few of them get translated into English, a fan of incremental games may find the available games interesting.

Last updated:

- + \ No newline at end of file diff --git a/garden/guide-to-incrementals/index.html b/garden/guide-to-incrementals/index.html index 6e17884d..8276fef4 100644 --- a/garden/guide-to-incrementals/index.html +++ b/garden/guide-to-incrementals/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Guide to Incrementals ​

This is a comprehensive guide to Incremental Games, a genre of video games. It will explore defining the genre, why it's appealing, and how to design and build your own incremental game. Along the way will be interactive examples, snippets from other creators, and relevant material to contextualize everything.

Note: This is an incomplete document. I want to keep adding opinions and opposing views from other incremental games developers, and add interactive examples to illustrate various points regarding game design and balancing. Consider this a living document - and see the changelog at the end.

Note: This was made before my switch to a digital garden, and is written as prose. Hope you don't mind!

Why am I making this? ​

That's a good question! What authority do I have to be making this guide? I haven't made the best incremental games, nor the most incremental games, certainly not the most popular ones either. But I do have some formal education in game development, know a lot of incremental game devs (as well as other game devs), and have a passionate interest in ludology, classifying genres, etc. I've also made a couple of incremental games) myself.

If you have any additional questions about my credentials or anything on this site, feel free to reach out!

Ludology ​

Making an Incremental ​

Last updated:

- + \ No newline at end of file diff --git a/garden/guide-to-incrementals/navigating-criticism/index.html b/garden/guide-to-incrementals/navigating-criticism/index.html index a30a73ce..4a0200d9 100644 --- a/garden/guide-to-incrementals/navigating-criticism/index.html +++ b/garden/guide-to-incrementals/navigating-criticism/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Guide to Incrementals/Navigating Criticism ​

Developing games is fun and exciting and teaches a lot of wonderful skills - I enthusiastically encourage anyone with an interest in game development to try it out - and incremental games are a wonderful way to get started. However, there are many challenges young and inexperienced developers have to face, and I think the hardest one - harder than coding, debugging, balancing, etc. - is handling criticism. When you put your heart and soul into a game it is natural to feel very vulnerable. While I think there's a lot communities can do to ensure they're welcoming, positive and constructive with their criticisms, inevitably you will eventually read some, and potentially a lot, of comments that can deeply affect you. No one is immune to this, from young incremental game developers to the largest content creators you can think of. That's why it's important to be able to process and navigate criticism, because ultimately collecting feedback is essential to the journey to becoming a better developer. On this page, we'll explore how to embrace criticism, grow from it, and continue to post your games publicly with confidence.

Reading Feedback ​

Game development is a skill that takes time and practice to get truly great at. Criticism and other constructive feedback are vital to continually improving. It's useful to look at the criticism as solely a tool for improving this game and future games - that is to say, it should never be used against you as a person. Insults towards the developer(s) themselves are never okay and should not be allowed within whatever community you're sharing your works in. If you do come across a comment you interpret as an attack upon your person, you should report it. For other negative comments, try not to internalize them; instead, focus on improving the game. By distancing your own identity from your work emotionally, you can better analyze the game and use the feedback to your advantage.

Not all feedback is made equal, and you don't need to feel compelled to read and obey every piece of feedback you receive. Learn to distinguish between constructive feedback and unhelpful comments. Constructive feedback typically offers specific suggestions for improvement, while unhelpful comments are often vague or hurtful. Prioritize the former and disregard the latter. That said, most feedback you get will not be from game developers, so take specific suggestions with a grain of salt. Determine the actual problem they're experiencing, and design what you believe the best solution to that problem would be, regardless if that's the specific solution the player asked for. And keep in mind, due to different player preferences you'll never satisfy everyone, and you don't need to. Ultimately if even just you find the game fun, then that's a success.

Seeking Feedback ​

When deciding where to share your game, consider the type of players you anticipate getting, and the kind of feedback you can anticipate receiving. Different communities will have different levels of support for learning developers, and certain communities may prefer certain types of games or mechanics. It's important to get a diverse set of feedback focused on players you think will enjoy the specific game you're making.

Collecting feedback from other game developers is incredibly helpful. They've trained themselves to recognize good and bad game design and how to articulate the differences, and from my experience are much more likely to leave positive and constructive comments since they've been in your shoes before! They understand the struggles and can offer guidance and emotional support.

Responding to Feedback ​

Negative feedback can naturally feel like an attack, and it's okay to get angry. However, lashing back is never the appropriate response. It's best to cool off IRL, and keep in mind all the positive comments you've received. There's a concept in Psychology called negative bias that explains how negative feedback tends to stick with us much more prominently than positive feedback, so it's useful to regularly remind yourself of all the positive feedback you've received. Celebrate your successes, no matter how small they may seem - getting a game to a state you can publicly share it with people is an accomplishment in and of itself!

Remember your passion and your initial reasons for getting into game development. The journey will have its ups and downs, but staying true to your vision and passion will keep you motivated.

Last updated:

- + \ No newline at end of file diff --git a/garden/guide-to-incrementals/what-is-content/index.html b/garden/guide-to-incrementals/what-is-content/index.html index 41db71e0..fa28ebed 100644 --- a/garden/guide-to-incrementals/what-is-content/index.html +++ b/garden/guide-to-incrementals/what-is-content/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Guide to Incrementals/What is Content? ​

If you've been in the incremental games community for any amount of time, you'll quickly find the number one thing players want is content. They want as much of it as possible! The most popular incremental games have tons of content, so they just keep stretching on and on and on, introducing mechanic after mechanic, and players love it. In fact, players seem to value the amount of content over the quality of any specific content. However, there's a bit of a lack of understanding concerning what content is, and I'd like to explore what counts as content, and how we measure it. As a baseline definition, I think "content" can just be described as the parts of the game that engage the player, but to truly understand it we need to contextualize what that means and how it affects the gameplay experience.

To clarify the purpose of this page, my goal is not to get (too) nitpicky or to attack games with "low content". There's nothing wrong with short / low-content games - I'm quite a big fan of those games myself! This is mostly targeted toward those who ask for content and settle for "long" games, and those who want to provide content but want to make sure they're not just artificially inflating the game. Ultimately, I suppose the goal is to just reduce the amount of artificially inflated content for the sake of having a "longer" game.

Interaction ​

I think it should be a fairly non-controversial opinion that time spent solely waiting should not count towards content. That is not including the time reading various effects or making decisions in your head, but rather time spent waiting for a condition to be met so you can re-engage with the game.

That is not to say games should necessarily try to minimize this time. Plenty of games lead towards more infrequent interaction and still get popular. In fact, these games appeal to many gamers who want to have something to check up on in between bursts of working on some other activity. These games seem to have fallen slightly out of fashion amongst modern incremental games, but they're still fully valid. The point I'm trying to make here is just that this time is not content. As an extreme example, a game with no interactions and just a counter that goes up every second could safely be said to have 0 content beyond the time it takes to understand what's going on. If it has a list of "goals" to hit, then the time understanding those goals and a short time after achieving each one could be considered content, but not the idle times in between.

Let's take a look at the opposite end of the spectrum - interaction that is so frequent as to become mindless. This is any mechanic where you need to spam-click something to progress. This may be a more controversial take, but I do not believe this constitutes content either. It does not engage the player, because each consecutive click blends together and they do not individually change the gameplay experience. That is to say, a single click and 100 clicks are not meaningfully different in terms of engaging the player. I'd go as far as to say clicking 100 times would be actively worse, as it's artificially delaying the next piece of actual content, alongside the issues of accessibility and potentially causing RSI.

Repeatable Purchases ​

Imagine an entity in a game that you can purchase multiple times, each time it performs the same thing but for a higher cost. These are incredibly common, from the buildings in cookie clicker to the units in swarm sim to the IP and EP multipliers in antimatter dimensions. However, how much content is each specific purchase? Is it content beyond the first purchase? Does it have diminishing returns? What if you are oscillating between two different repeatable purchases? How much content is lost when you automate) away a repeatable purchase?

I don't want to take too harsh a stance against repeatable purchases. They're useful tools and can be used in a myriad of interesting ways. I feel they do become "stale" or less meaningful content over time, and this happens exponentially quickly the more frequently it can be purchased. A classic example that I believe goes too far is the IP/EP multipliers in Antimatter Dimensions. I would go as far as to say they are a chore and do not provide any meaningful content after you've bought them a couple of times. It's a method for inflating numbers (effectively making every OOM a 5x step instead of 10x), that punishes the player progression-wise whenever they forget to max it again, and eventually gets automated away as a reward to the player for making enough progress.

Just to voice the other side of this argument, Acamaeda defended the IP multiplier as giving the player a "good" upgrade every OOM. I can understand that to a point and need to clarify I'm mainly criticizing IP/EP multipliers after they've been introduced for a while. In fact, I would defend the multipliers for a short while after they're introduced using the same logic I would use to defend normal dimensions as repeatable purchases, at least pre-infinity. There's "content" to be had in looking at what dimensions will become affordable next, and then choosing which to buy amongst those. The IP/EP multipliers, early into infinity or eternity respectively, provide another option that gets put into that mental queue of things to buy with each OOM reached - although the optimal order is often quite trivial and not particularly engaging.

The IP/EP multipliers are not the only repeatable purchase in antimatter dimensions I take offense to. The time dimensions are also a series of repeatable purchases, that are all so similar and static that it doesn't take long before you never need to put any thought into buying them, how much you're buying at once, or the order you buy them in - you just press max all and move on. The entire tab could've been just the max all button and it would not have made a difference beyond the start of the eternity layer. The normal dimensions technically have this problem as well, but since you're constantly getting antimatter the order feels like it has a larger impact and it's more meaningful content, right up until they're automated away. Infinity dimensions are a compromise between the two, so I'm highlighting time dimensions here as the most egregious.

Following Instructions ​

We're getting more and more controversial as we go along! Let's talk about how linear content is not content now (in some circumstances). A trend in incremental games is adding difficulty by adding a web of effects that abstract the true change you can expect from any specific purchase or decision you make. If a game is both linear and sufficiently abstracts the effect of player decisions, then the player will no longer be engaging with the content - they'll simply be clicking on things as they become available. This isn't necessarily a bad thing, as plenty of players don't mind this style of gameplay, but I'd argue once you reach a point where players don't bother reading the effects, those interactions are no longer truly content. Note that unlike the previous qualifiers mentioned, this qualifier is based on the player, and therefore subjective. In effect, it's a spectrum where the more complicated the web of effects becomes, the more likely it is to disengage the player.

This over-complicatedness leading to disengaging the player can also happen from non-linear gameplay. If the web of effects becomes sufficiently complicated and finding the optimal progression route too time-consuming to discover, players will seek out guides from other players who've completed the game. The second they do this, the game effectively becomes linearly following the instructions of the guide and all the above criticisms apply. Similarly to as before, though, this is a spectrum and not everyone will seek out a guide at the same level of difficulty.

Automation

Automation is a staple of the genre, but it has certain implications for the design of the game. Why, when new content is introduced, must the older content be automated away - why is it a chore and it feels rewarding to not have to do it again? Why does the new mechanic have such appeal if we know it too will just be automated away later on, and we'll be happy when that happens? It honestly begs the question of why this framework of introducing content and automating the old content is even enjoyable - and nearly nonexistent in other genres. You're not going to reach a point in a platformer game where they just automate the jumping part - that's the core mechanic! Instead, platformers either add new mechanics that build on the core mechanic or at least re-contextualize the core mechanic. However, in incremental games new content very frequently means replacing older content, as opposed to augmenting it.

Admittedly, the above paragraph ignores the obvious answer that separates incremental games in this regard. These mechanics become chores as their frequency increases. The frequency increases to give a sense of progression, and automation is seen as a reward because it now manages what was becoming unmanageable. The new content then comes in and continues the loop to give a stronger sense of progression. That's all good and a fine justification for automating content instead of building upon the base mechanic. It's also much easier to design, as each layer essentially lets you start over instead of needing to think of ideas that conform to the original core mechanic.

So, what's the problem? Even if this trend is justified and easy to implement, there are some other effects it has on the game design. First off, and this is probably a neutral point, incremental games with this cycle of replacing old mechanics with new ones trend towards more and more abstract and further away from any narrative throughline as they add layers. There are only so many justifications for resetting progress, so if a game wants to have several of these layers they're inevitably going to become generic or increasingly loosely associated with the original content. It's most unfortunate, in my opinion when an interesting or innovative core mechanic gets fully automated once a generic "prestige" layer is unlocked.

A recent example is Really Grass Cutting Incremental, an incremental game about cutting grass (although I'm really criticizing the Roblox game it's based on). Except, it doesn't continue to be about cutting grass. After you buy enough upgrades to increase your grass cutting and level up sufficiently you "prestige", an abstract term that in this case means you reset all your progress to get some currency to buy upgrades that do the same things as the original upgrades, but these won't reset on future prestiges. You'll eventually be able to "crystallize", which means you reset all your progress to get some currency to buy upgrades that do the same things as the original upgrades (and a couple of new ones) and won't reset on future crystallizes. Fine. You'll progress a bit, complete some challenges, and finally get to... grasshop? Grasshopping is this mechanic where you reset all your progress to get some resource that isn't for buying upgrades - this time you just unlock different modifiers on everything based on their amount. You may have gotten the point by now, but there are also "steelie" resets which give you steel for some reason, before unlocking a factory with various machines - none of which are directly tied to cutting grass, and start gathering things like oil and reset for rocket parts and reset to go to space and so on and so on. Throughout all of this there is absolutely no narrative justification or throughline for the direction the game is going, or why cutting grass is still relevant when we're collecting things like rocket parts. I may be going a little hard on GCI, but it is far from alone.

Tips for Developers ​

If you're a developer, by this point you should have a pretty decent idea of how to create "true" content in your game. Here are some other specific tips I'd suggest:

An upgrade that simply unlocks another upgrade trivially isn't content. However, many games have an upgrade that just unlocks a feature, which then has a wait or other requirements before it can be used. Try to make sure when you unlock a feature, there is immediately something to do with the feature - for example, perhaps give them a small amount of the new currency it unlocks, if applicable.

If you don't have a large web of effects, and can definitively say the impact of a purchase is to multiply the gain of the cost currency by N, and the next purchase costs N times the amount of that same currency, then this purchase effectively made no difference and it may have made more sense to just go directly to the next upgrade. That said, having effects based on things like the number of purchases made will quickly invalidate this tip.

Last updated:

- + \ No newline at end of file diff --git a/garden/incremental-social/index.html b/garden/incremental-social/index.html index a79f507f..39dbaf4b 100644 --- a/garden/incremental-social/index.html +++ b/garden/incremental-social/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Last updated:

- + \ No newline at end of file diff --git a/garden/ivy-road/index.html b/garden/ivy-road/index.html index 1a5055a6..17f3256e 100644 --- a/garden/ivy-road/index.html +++ b/garden/ivy-road/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Ivy Road ​

Referenced by: Davey Wreden, Wanderstop

Tags: Davey Wreden

Ivy Road is a indie game studio created by Davey Wreden, Karla Kimonja, and C418

Last updated:

- + \ No newline at end of file diff --git a/garden/kronos/index.html b/garden/kronos/index.html index 85bf2586..27845851 100644 --- a/garden/kronos/index.html +++ b/garden/kronos/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Kronos ​

Referenced by: V-ecs

Tags: My Projects, Profectus

My largest and most ambitious incremental game I've ever made

  • A magnum opus, of sorts ;P

Still in development, and will be for a long time. I have full intention of completing it, however

An older version, that is built in The Modding Tree, only has the gameplay, and only goes up to Chapter 2, can be played here

Last updated:

- + \ No newline at end of file diff --git a/garden/logseq/index.html b/garden/logseq/index.html index e21bccc3..431833d7 100644 --- a/garden/logseq/index.html +++ b/garden/logseq/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Logseq ​

Referenced by: This Knowledge Hub

Logseq is an Open Source outlining software

Last updated:

- + \ No newline at end of file diff --git a/garden/matrix/index.html b/garden/matrix/index.html index db76daa6..bf265afe 100644 --- a/garden/matrix/index.html +++ b/garden/matrix/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Matrix ​

Referenced by: Cinny, Commune, Synapse

Matrix is a protocol for Decentralized messaging

Last updated:

- + \ No newline at end of file diff --git a/garden/mbin/index.html b/garden/mbin/index.html index 46ef007b..e7f0d67b 100644 --- a/garden/mbin/index.html +++ b/garden/mbin/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Mbin ​

Referenced by: Incremental Social

Mbin is an Open Source Fediverse software

Can show both twitter-style posts and reddit-style threads

Last updated:

- + \ No newline at end of file diff --git a/garden/my-personal-website/index.html b/garden/my-personal-website/index.html index 4319f09e..db460f27 100644 --- a/garden/my-personal-website/index.html +++ b/garden/my-personal-website/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

My Personal Website ​

Referenced by: The Small Web

A Personal Websites for me, available at https://thepaperpilot.org

Last updated:

- + \ No newline at end of file diff --git a/garden/my-projects/index.html b/garden/my-projects/index.html index 0451329e..cf0c3a40 100644 --- a/garden/my-projects/index.html +++ b/garden/my-projects/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

My Projects ​

Tagged by: Advent Incremental, Babble Buds, Capture the Citadel, Dice Armor, Game Dev Tree, Incremental Social, Kronos, Opti-Speech, Planar Pioneers, Profectus, V-ecs

I like making games and tools!

Games ​

Tools (and other non-games) ​

Last updated:

- + \ No newline at end of file diff --git a/garden/nostr/index.html b/garden/nostr/index.html index d6338d0d..de90e59b 100644 --- a/garden/nostr/index.html +++ b/garden/nostr/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Nostr ​

Referenced by: Fediverse

Tags: Decentralized

Nostr is a protocol for Federated Social Media

Last updated:

- + \ No newline at end of file diff --git a/garden/open-source/index.html b/garden/open-source/index.html index efa96c31..000d8639 100644 --- a/garden/open-source/index.html +++ b/garden/open-source/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Open Source ​

Referenced by: Advent Incremental, Cinny, Commune, Dice Armor, Forgejo, Game Dev Tree, Logseq, Mbin, Planar Pioneers, Profectus, Synapse, Vitepress, Weird

Projects with the source code publicly accessible

Typically also grants users the right to modify the code and redistribute those changes, depending on the license

Last updated:

- + \ No newline at end of file diff --git a/garden/opti-speech/index.html b/garden/opti-speech/index.html index e9456f0d..f7b7ba45 100644 --- a/garden/opti-speech/index.html +++ b/garden/opti-speech/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Opti-Speech ​

Tags: My Projects

In college I continued development on the Opti-Speech project, originally built alongside the scientific paper Opti-speech: a real-time, 3d visual feedback system for speech training

The Original Project ​

The Optispeech project involves designing and testing a real-time tongue model that can be viewed in a transparent head while a subject talks — for the purposes of treating speech errors and teaching foreign language sounds. This work has been conducted in partnership with Vulintus and with support from the National Institutes of Health (NIH).

system-architecture-600.jpg

This video shows a talker with WAVE sensors placed on the tongue hitting a virtual target sphere located at the alveolar ridge. When an alveolar consonant is hit (e.g., /s/, /n/, /d/) the sphere changes color from red to green.

This video shows an American talker learning a novel sound not found in English. When the post-alveolar consonant is hit, the target sphere changes color from red to green. Here, the NDI WAVE system serves as input.

My Work ​

As the sole programmer at UT Dallas Speech Production Lab at the time, my changes involved updating to a more modern version of Unity, improving the interface, in general cleaning up tech debt so it can more easily support new features, and added support for additional EMA systems, namely the Carstens AG501.

new-interface.png

In addition, the program now includes documentation and unit tests to improve program stability and maintainability going forward.

documentation.png

unittests.png

Last updated:

- + \ No newline at end of file diff --git a/garden/planar-pioneers/index.html b/garden/planar-pioneers/index.html index 74bde193..17d4eb5e 100644 --- a/garden/planar-pioneers/index.html +++ b/garden/planar-pioneers/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Planar Pioneers ​

Tags: My Projects, Profectus

Play it here!

An Open Source game designed to show off Profectus' dynamic layer system!

The TV Tropes page on this game mentions some of the cool things about this game

Last updated:

- + \ No newline at end of file diff --git a/garden/profectus/index.html b/garden/profectus/index.html index 3c042ce5..abaf6e38 100644 --- a/garden/profectus/index.html +++ b/garden/profectus/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Profectus ​

Referenced by: Advent Incremental, Planar Pioneers

Tagged by: Advent Incremental, Kronos, Planar Pioneers

Tags: My Projects

Profectus is an Open Source game engine I made, loosely based on The Modding Tree by Acamaeda

Technically it's more of a template for making web games

It centers around using Vue's reactivity and is designed with the intent to not restrain developers into making games that only look or behave "one way"

Games made with Profectus:

  • Everything in this garden tagged with this page!
  • The entries to the Profectus Creation Jam
  • Primordia by Jacorb

Last updated:

- + \ No newline at end of file diff --git a/garden/social-media/index.html b/garden/social-media/index.html index 3cf8e02d..cd9e53d0 100644 --- a/garden/social-media/index.html +++ b/garden/social-media/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Social Media ​

Referenced by: Commune, Fedi v2, Fediverse

Traditional social media

  • Not Decentralized
    • Can't choose your own rules, sorting methods, data queries, etc.
  • Overrun by scams and ads and influencers

Federated Social Media

  • Partially Decentralized
    • Self hosting is too hard for everyone to do
    • Still subject to instance's moderation, limitations, etc.
  • Users need to pick an instance, associating their identity with one specific group
    • People belong to many groups
    • The person is permanently associated with that one group
    • You have to pick before getting a "trial period" to ensure you actually like that group/instance

My take on an ideal social media Fedi v2

Last updated:

- + \ No newline at end of file diff --git a/garden/synapse/index.html b/garden/synapse/index.html index 149c5b9b..0285f44e 100644 --- a/garden/synapse/index.html +++ b/garden/synapse/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Synapse ​

Referenced by: Incremental Social

Synapse is an Open Source server software for the Matrix protocol

Last updated:

- + \ No newline at end of file diff --git a/garden/the-beginner-s-guide/index.html b/garden/the-beginner-s-guide/index.html index 1b3b5f69..22dcdd57 100644 --- a/garden/the-beginner-s-guide/index.html +++ b/garden/the-beginner-s-guide/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

The Beginner's Guide ​

Tags: Davey Wreden

My favorite video game of all time, bar none. Created by Davey Wreden

The game broadly comments on the relationship between creators and consumers, and it can apply to all forms of art

  • Perhaps also an important commentary on parasocial relationships

Important analyses:

Last updated:

- + \ No newline at end of file diff --git a/garden/the-cozy-web/index.html b/garden/the-cozy-web/index.html index 7a195fe8..27fb0f8c 100644 --- a/garden/the-cozy-web/index.html +++ b/garden/the-cozy-web/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

The Cozy Web ​

Referenced by: Digital Gardens, The Small Web

The Cozy Web is an extension of the dark forest theory of the Internet

It refers to the part of the web that is not web indexable

This part of the web is known for not typically having ads or marketers

Popularized by this article written by Maggie Appleton, who has also written a lot about Digital Gardens

Last updated:

- + \ No newline at end of file diff --git a/garden/the-small-web/index.html b/garden/the-small-web/index.html index 4abf5248..72aaabc3 100644 --- a/garden/the-small-web/index.html +++ b/garden/the-small-web/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

The Small Web ​

Referenced by: This Knowledge Hub

Small personal websites created by individuals

  • My Personal Website
  • A callback to how the web was before social media, which homogenized content
  • These pages are diverse and typically won't have ads or marketers

The small web as a whole is Freeform

  • Individual sites may be Chronological still
  • Individual sites link between each other in ways similar to wikis

Browsing the small web ​

  • Follow Webrings or other links from known small websites
  • Marginalia is a search engine for non-commercial content with a "random" button and filters for the small web explicitly (amongst other useful filters!)

Building personal websites ​

IndieWeb contains various resources

  • Their building blocks are standards people can use to help the small web connect with each other consistently
  • They discourage the use of site builders or templates that end up making sites look too homogenized

Free hosting for static websites:

Streams ​

Microsub is a proposed protocol to support this

  • That way, people could use microsub clients to subscribe to multiple streams and get them in one feed
  • Effectively a Federated Social Media that works through personal websites
  • Announce new posts using WebSub

This also allows your personal website to be the one source of truth for your posted content

Multiple streams can be hosted by one site/person so people can subscribe to the kind of content they're interested in

How viable would it be to include chat messages in a stream as well?

  • Perhaps with Chat Glue you could link to specific branches I chatted in

Digital Gardens ​

These sites may be useful to occasionally check up on rather than get notifications from on every post/change

  • Although Garden-RSS could allow those who want to receive notifications to do so

Why people want the small web ​

There are tools these days that make making websites incredibly easy

  • Back in the day geocities was pretty complicated but a lot of people managed to make pages there
  • Neocities has an extensive page on Learn How to Make Websites!

Hosting can be expensive, but static websites are cheap

  • There are plenty of free options out there for hosting static websites
  • People are creative and love creating things

Last updated:

- + \ No newline at end of file diff --git a/garden/this-knowledge-hub/index.html b/garden/this-knowledge-hub/index.html index 1bda921d..1a4dcbcd 100644 --- a/garden/this-knowledge-hub/index.html +++ b/garden/this-knowledge-hub/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

This Knowledge Hub ​

Referenced by: Digital Gardens

This is my knowledge hub!

  • It's a Digital Garden collecting my thoughts in varying levels of completeness on basically anything I have interest in

This is not Wikipedia. My thoughts are biased and argumentative, but to the best of my ability based on fact and expertise

I'm writing on something essentially every day

  • Most of my pages are private, especially the journal pages
  • I'll only push updates to this site every so often (not an automatic process)
  • Until something like Garden-RSS exists, we'll have to make do with /changelog which gives a git diff summary for every pushed change, in the form of a The IndieWeb stream as well as an RSS feed

Written in Logseq and rendered with Vitepress

Suggested pages:

Last updated:

- + \ No newline at end of file diff --git a/garden/v-ecs/index.html b/garden/v-ecs/index.html index ddceec9a..7a99a7b3 100644 --- a/garden/v-ecs/index.html +++ b/garden/v-ecs/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

V-ecs ​

Tags: My Projects

screenshot.png

V-ecs (pronounced "Vex") is a Vulkan-based engine I made for making highly moddable games and tools in Lua centered around the ECS design pattern and a work-stealing job system.

The engine works with "worlds", which are collections of systems and renderers. The engine comes with several worlds using systems and renderers I made, including a voxel world, an incremental game, and some test scenes. All of these include systems to render the fps as well as show a debug console by typing the grave key (`). The default world is a title screen that detects any worlds in the "worlds" folder and displays a button for each of them.

debug.png

The original plans were to eventually put it on the steam workshop so people could more easily share their creations amongst each other, but I never became happy enough with the performance of the engine - the parallelization of the lua code involved a lot of overhead that severely limited performance.

Instead, I made a couple of worlds by myself - an infinite procedurally generated voxel world, a simple incremental game, and a more complex incremental game I call "Sands of Time".

sandsoftime.png

The gameplay of Sands of Time was replicated in Kronos Chapter 2!

Last updated:

- + \ No newline at end of file diff --git a/garden/vitepress/index.html b/garden/vitepress/index.html index eef9e7e1..60cff07d 100644 --- a/garden/vitepress/index.html +++ b/garden/vitepress/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Vitepress ​

Referenced by: This Knowledge Hub

Vitepress is an Open Source static site generator

Last updated:

- + \ No newline at end of file diff --git a/garden/wanderstop/index.html b/garden/wanderstop/index.html index 50cd1ae8..a14b6582 100644 --- a/garden/wanderstop/index.html +++ b/garden/wanderstop/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Wanderstop ​

Tags: Davey Wreden

Wanderstop is the first game by Ivy Road. It's a narrative focused cozy game

Last updated:

- + \ No newline at end of file diff --git a/garden/webrings/index.html b/garden/webrings/index.html index 7c19600f..525dee52 100644 --- a/garden/webrings/index.html +++ b/garden/webrings/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Webrings ​

Referenced by: The Small Web

A collection of Personal Websites that link to each other

  • These websites are all endorsing each other
  • They form a network of related sites readers might be interested in
  • Built on human trust rather than algorithms

Commune has a vision for modern webrings

  • Have communities set up matrix spaces for chatting
  • Multiple spaces can contain the same room
  • Related communities can share a room about a relevant topic
    • e.g. a bunch of game development libraries shared a "Game Design" room
  • This allows smaller communities to grow from cross-pollinating with other related communities
  • Could Incremental Social host a shared "Incremental Games" room?
    • How to bridge one channel to multiple discord servers, since that's where most incremental games communities are
    • Would this be appealing to already large communities?
    • Would this be overwhelming to smaller communities?
    • Who would moderate?

Last updated:

- + \ No newline at end of file diff --git a/garden/weird/index.html b/garden/weird/index.html index 551db5d1..53c6202f 100644 --- a/garden/weird/index.html +++ b/garden/weird/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Weird ​

Referenced by: Commune, Fedi v2, The Small Web

Weird is an Open Source project by the Commune team currently in development

Last updated:

- + \ No newline at end of file diff --git a/guide-to-incrementals/design/criticism/index.html b/guide-to-incrementals/design/criticism/index.html index db006a78..474cbc6a 100644 --- a/guide-to-incrementals/design/criticism/index.html +++ b/guide-to-incrementals/design/criticism/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Guide to Incrementals/Navigating Criticism ​

Developing games is fun and exciting and teaches a lot of wonderful skills - I enthusiastically encourage anyone with an interest in game development to try it out - and incremental games are a wonderful way to get started. However, there are many challenges young and inexperienced developers have to face, and I think the hardest one - harder than coding, debugging, balancing, etc. - is handling criticism. When you put your heart and soul into a game it is natural to feel very vulnerable. While I think there's a lot communities can do to ensure they're welcoming, positive and constructive with their criticisms, inevitably you will eventually read some, and potentially a lot, of comments that can deeply affect you. No one is immune to this, from young incremental game developers to the largest content creators you can think of. That's why it's important to be able to process and navigate criticism, because ultimately collecting feedback is essential to the journey to becoming a better developer. On this page, we'll explore how to embrace criticism, grow from it, and continue to post your games publicly with confidence.

Reading Feedback ​

Game development is a skill that takes time and practice to get truly great at. Criticism and other constructive feedback are vital to continually improving. It's useful to look at the criticism as solely a tool for improving this game and future games - that is to say, it should never be used against you as a person. Insults towards the developer(s) themselves are never okay and should not be allowed within whatever community you're sharing your works in. If you do come across a comment you interpret as an attack upon your person, you should report it. For other negative comments, try not to internalize them; instead, focus on improving the game. By distancing your own identity from your work emotionally, you can better analyze the game and use the feedback to your advantage.

Not all feedback is made equal, and you don't need to feel compelled to read and obey every piece of feedback you receive. Learn to distinguish between constructive feedback and unhelpful comments. Constructive feedback typically offers specific suggestions for improvement, while unhelpful comments are often vague or hurtful. Prioritize the former and disregard the latter. That said, most feedback you get will not be from game developers, so take specific suggestions with a grain of salt. Determine the actual problem they're experiencing, and design what you believe the best solution to that problem would be, regardless if that's the specific solution the player asked for. And keep in mind, due to different player preferences you'll never satisfy everyone, and you don't need to. Ultimately if even just you find the game fun, then that's a success.

Seeking Feedback ​

When deciding where to share your game, consider the type of players you anticipate getting, and the kind of feedback you can anticipate receiving. Different communities will have different levels of support for learning developers, and certain communities may prefer certain types of games or mechanics. It's important to get a diverse set of feedback focused on players you think will enjoy the specific game you're making.

Collecting feedback from other game developers is incredibly helpful. They've trained themselves to recognize good and bad game design and how to articulate the differences, and from my experience are much more likely to leave positive and constructive comments since they've been in your shoes before! They understand the struggles and can offer guidance and emotional support.

Responding to Feedback ​

Negative feedback can naturally feel like an attack, and it's okay to get angry. However, lashing back is never the appropriate response. It's best to cool off IRL, and keep in mind all the positive comments you've received. There's a concept in Psychology called negative bias that explains how negative feedback tends to stick with us much more prominently than positive feedback, so it's useful to regularly remind yourself of all the positive feedback you've received. Celebrate your successes, no matter how small they may seem - getting a game to a state you can publicly share it with people is an accomplishment in and of itself!

Remember your passion and your initial reasons for getting into game development. The journey will have its ups and downs, but staying true to your vision and passion will keep you motivated.

- + \ No newline at end of file diff --git a/guide-to-incrementals/index.html b/guide-to-incrementals/index.html index e2ad9fa7..336fd1b2 100644 --- a/guide-to-incrementals/index.html +++ b/guide-to-incrementals/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Guide to Incrementals ​

This is a comprehensive guide to Incremental Games, a genre of video games. It will explore defining the genre, why it's appealing, and how to design and build your own incremental game. Along the way will be interactive examples, snippets from other creators, and relevant material to contextualize everything.

Note: This is an incomplete document. I want to keep adding opinions and opposing views from other incremental games developers, and add interactive examples to illustrate various points regarding game design and balancing. Consider this a living document - and see the changelog at the end.

Note: This was made before my switch to a digital garden, and is written as prose. Hope you don't mind!

Why am I making this? ​

That's a good question! What authority do I have to be making this guide? I haven't made the best incremental games, nor the most incremental games, certainly not the most popular ones either. But I do have some formal education in game development, know a lot of incremental game devs (as well as other game devs), and have a passionate interest in ludology, classifying genres, etc. I've also made a couple of incremental games) myself.

If you have any additional questions about my credentials or anything on this site, feel free to reach out!

Ludology ​

Making an Incremental ​

- + \ No newline at end of file diff --git a/guide-to-incrementals/ludology/appeal-developers/index.html b/guide-to-incrementals/ludology/appeal-developers/index.html index 1f03373e..f936293e 100644 --- a/guide-to-incrementals/ludology/appeal-developers/index.html +++ b/guide-to-incrementals/ludology/appeal-developers/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Guide to Incrementals/Appeal to Developers ​

There are a lot of developers in the incremental games community - the genre seems to draw them in, and convert a lot of players into developers. Let's explore the reasons why this genre appeals to developers.

Incrementals are Easy to Make ​

Compared to other genres, incrementals have quite low expectations. You don't need to make fancy art, or music, or lay things out nicely. If you can make a button and learn the few lines of code necessary to make a number go up, you can make an incremental. This low threshold makes the genre perfect for those who are actively learning to code and haven't developed any gamedev-related skills yet.

Additionally, unlike other genres incrementals are uniquely easy to implement in a normal web page - no need to worry about rendering sprites, moving them around, implementing physics, etc. New developers can just use HTML to add a button, and the game is now available in your browser. You don't need to choose an engine, have admin privileges, or hell for the dedicated you don't even need a computer - there are tools for web development that run in the browser itself, so you can technically use your phone if that's all you have.

Javascript is a perfectly viable language for making web games, whereas other genres are typically going to require using other more difficult languages to learn. There are countless javascript tutorials that start from 0 knowledge of programming, making it incredibly accessible to beginners.

Players are Easy to Find ​

Once you've finished your game and uploaded it on github pages or itch or just copied the link if you're using glitch or replit (all of which are easy to do), anyone can now play the game in their browser. This low barrier to entry has shown tremendous success in getting completely unknown developers to have thousands of plays.

The incremental games community, which mostly centers around r/incremental_games, is always looking for new games and tends to flood any new ones posted with initial players.

Having your games be played can be incredibly motivating, and the community makes it quite clear that you can expect players to play your game. These communities - both for incremental games in general as well as game-specific communities - tend to be very developer friendly as well. A lot of the developers know each other, and welcome new developers with open arms, often with dedicated channels for programming help and discussions.

Monetization ​

I'd like to clarify that everything I've said above mainly applies to web-based incrementals. Incremental games are also incredibly popular on mobile, but with a much different culture and community. Many mobile gamers will still participate in the web-focused community for the culture. This web-focused community has a culture that has been criticized for being "anti-monetization". Ads, IAPs, and similar forms of monetization are often criticized, mainly due to the abundance of completely non-monetized games available from hobbyist developers. There are exceptions, like paid games often being considered fine, like Increlution or Stuck in Time, or donation ware games like kittens game, but even popular games that have IAP see some level of regular criticism, like NGU Idle, Idle Skilling, or Idle Pins. A large part of this can be explained by the community being hyper-aware of the addictive) nature of this genre and its susceptibility to exploiting players.

On mobile, however, monetization is the norm and expected. If an incremental game is available on mobile, it almost certainly will be monetized, and mobile players are aware and accepting of that. Mobile incremental games, due to their addictive nature, tend to make a lot of money. It's very lucrative, and therefore these games are quite abundant on mobile storefronts.

- + \ No newline at end of file diff --git a/guide-to-incrementals/ludology/appeal-gamers/index.html b/guide-to-incrementals/ludology/appeal-gamers/index.html index b2f6d5f5..0b1923cf 100644 --- a/guide-to-incrementals/ludology/appeal-gamers/index.html +++ b/guide-to-incrementals/ludology/appeal-gamers/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Guide to Incrementals/Appeal to Players ​

This is something that has been discussed and analyzed by many people, and to some extent, I feel like everything that can be said on the topic already has. However, a lot of these analyses are from the perspective of those with not as much experience and involvement within the genre as I'd argue would be necessary for a fully contextualized answer. I recently watched a video about Vampire Survivors, which has since been taken down due to drawing negative attention, which made me think about some interesting arguments about what games are, and what makes them good. The video's argument that "Vampire Survivors is not a video game" mirrors a claim by the developer of Cookie Clicker that his games are "non-games". Using Vampire Survivors and the video made on it as a framework, I'll be answering why incremental games appeal to players. Since the video has been taken down, I'll do my best to contextualize and generalize the arguments of the video without requiring the reader to watch it. For what it's worth, while I disagreed with the video I actually liked a lot of the way it went about thinking about games, and I consider this a continuation of that discussion.

Numbers Going Up ​

This is a very common response to why people enjoy incremental games, although it's not one I find compels me personally, and I suspect it might be a stand-in for progression) or Guide to Incrementals/What is Content?. But reportedly, some people do just like seeing big numbers. I must reiterate I suspect the actual cause is seeing big numbers in context though - if you start at 1e1000 of a currency and get to 1e1001, that isn't going to feel as satisfying as going from 1e10 to 1e100, and in any case, I don't think a button that just adds a zero to your number will feel quite satisfying - I believe its the sense of having made progress, and comparing where you are to where you started and feeling like you've earned your way here that is enjoyable.

Progression

Vampire Survivors can be argued to have a comparatively low depth to its combat compared to many other games. I'd argue it has sufficient depth and more than someone might expect who has only played the game for a short while, but it still definitely gets beat out by many other combat-focused games. Instead, a lot of the progression in Vampire Survivors comes from a meta-progression system by which base stats are increased by spending a currency that persists between runs. While it is technically possible to win without this meta-progression system, and indeed in many roguelikes players like to challenge themselves by beating the game without any meta-progression, the criticism can be made that meta-progression de-emphasizes player skill by making it less important to have to beat the game. Certainly, in incremental games, it is often literally impossible to complete a game without taking advantage of the meta-progression systems. I'd argue this does not detract from the game, however, and is actually a part of what makes incremental games, and roguelikes, enjoyable to many players: meta-progression augments the increases in skill the player is naturally gaining as they play. In effect, it's not replacing the skill increase, but exaggerating it to make it feel more real to the player.

Note: There is also a lot of progression from exploring the mechanics and discovering synergies, unlocking new weapons or playable characters, etc. That just isn't as relevant to this discussion, but it does make up a lot of the appeal of the game.

Effortlessness ​

Incremental games are so easy, a lot of them even have you progress while you're not playing! Part of the appeal is being able to feel like you're making progress while doing something actually productive - multitasking, in a way. In this sense, the game is more of a fidget toy - not something to think hard about and play actively, but something to click a few buttons every so often while you're paying attention to a lecture or studying or working. Of course, not all incremental games lend themselves to being played this way - it's specifically "idle" games that work like this. These are games that take an incredibly long amount of time to see all the content, stretching it as thin as possible, but they aren't expecting you to be sitting at your device playing it the entire time. They expect you to leave and come back later to make a bit of progress and repeat the cycle.

If you look at the higher-level play of most games, you'll see them perform difficult feats with ease and speed. They'll achieve a "flow state" that takes all their knowledge and experience of the game and uses it to play the game as instinctively as possible. It's incredible to watch things like Slay the Spire speed runs or competitive DDR-likes. I'd argue the goal of a lot of games with a competitive scene is to get so good that the game becomes effortless. In that sense, a game that allows you to reach that point earlier isn't any less legitimate, but rather lowers the barrier to entry by allowing more people to get "really good" at the game. And to be clear, Vampire Survivors and (most) incremental games aren't trivially easy - they, and to an extent, every game will have some level of learning and improvement over time.

Addiction

A lot of these reasons for why incremental games appeal may have reminded you of why gambling appeals to people, particularly those prone to addiction. Indeed, incremental games are quite often criticized for their similarity to a skinner box. Some have gone as far as to say incremental games as a genre are commenting that all games are skinner boxes). The argument goes that some games are not fun, but rather condition players into continuing to play without actually getting anything from the experience. When tied to real-world money this is seen as predatory, and to a lesser extent, even free games may be feeding the addictive sides of people and making them more prone to seek out gambling or micro-transaction heavy games.

While incremental games can be fun and even healthy in certain contexts, they can exacerbate video game addiction more than other genres. If you feel like playing incremental games is taking priority over other things in your life, or manipulating your sleep schedule, it may be prudent to seek help. See r/StopGaming for resources.

Since incremental games are often built on extrinsic motivations in the form of progression systems, it's hard to argue whether players continue to play because they are enjoying the gameplay, or if they are just conditioned to keep doing it because the game keeps rewarding them. Unfortunately, it can often feel like it's the latter, as there isn't typically anything compelling about the "gameplay" of clicking a button and waiting. There may be a significant overlap between those who enjoy incremental games and those who are most prone to addiction, and there are often posts on r/incremental_games about someone either struggling with or overcoming video game addiction.

Strategy ​

Incremental games could be considered a subset of strategy games), and inherit the appeals of strategy games. This includes the appeal of feeling like you've found a good solution to a puzzle, or that you're learning more about the game and are improving at making decisions within it. This applies to Vampire Survivors specifically, where you're learning about evolutions and synergies and what kinds of enemies can spawn under what conditions, and how best to handle them.

Note that strategy games are not all the same difficulty, as well. Vampire Survivors is still easier to play than Starcraft 2, and Cookie Clicker is probably somewhere in between (once you progress sufficiently). Vampire Survivors being so successful may indicate that "easier" strategies may have their separate appeal to harder strategy games - players like to feel smart and that they figured the game out and have optimized or mastered it, and the game being easier doesn't detract from that sense of accomplishment as much as it allows more and more users to be able to reach the point where they gain that sense.

Avoiding Staleness ​

Incremental games tend to have "paradigm shifts", where the gameplay changes in a meaningful way at various times throughout the progression of the game. These upset and change the gameplay loop, which helps keep them from stagnating. This constant "freshness" to the gameplay can keep players engaged for longer, compared to a game with a repetitive and static gameplay loop.

Good Game Design ​

Incremental games tend to show their game design "plainly", so it's more readily apparent if a game has good game design while playing, even if you're not looking for it. While different players have different preferences and might enjoy different types of games more than others, there are underlying good and bad game design principles that players will notice the effects of. To be clear, this isn't talking about stuff like big numbers being enjoyable, where I can comfortably agree to disagree with other players. They don't intrinsically make my experience better, but I'm aware of those for whom it does and I won't argue against their feelings. However, the game designer in me does feel like there are some extremely clear-cut examples of good and bad game design philosophies.

Let's start by giving an example of a mechanic I think can be easily and strongly argued is good game design. There are of course many examples, but a personal favorite of mine is how DOOM encourages aggressive gameplay by linking health drops to melee attacks. It has an intended experience it's trying to give the player - immersing themselves as DOOM guy, who would not hide behind cover when low on health - and this mechanic does a great job at encouraging and effectively teaching players to behave properly. This is in sharp contrast to shooters like Call of Duty, which have you regen health passively, encouraging players to hide behind cover and wait after getting hit. Note that I'm not arguing CoD is poorly designed, as the games have different intended experiences. I'm specifically praising DOOM for having a mechanic that does a good job at ensuring the player has that intended experience.

To contrast with an example I think is bad game design, let's talk about shields in souls-likes. This is a bit of a famous example, and I highly recommend this video essay which spends quite a good bit of time on this topic. Essentially, the argument boils down to players of earlier games in the souls games using shields too much - playing slowly, conservatively, and ultimately having less fun. Players wanted to feel safe, so they ended up playing in a way that ruined the experience for them. The developers solved this by removing shields, apart from an intentionally bad one effectively mocking the playstyle, and it did its job at getting players to play more aggressively, and often have more fun.

To bring the conversation back to incrementals, I'm incredibly opinionated on what makes a good incremental game, which I'll discuss in the game design section. Suffice it to say, incremental games rely more on good game design than other genres, due to not having much to distract from bad game design. This helps (although imperfectly - gamers are a bit too tolerant of bad game design!) well-designed games rise to the top within the genre.

Artistic Merit ​

The Vampire Survivors video made me think back to the old arguments about whether games are art, and whether they ought to be. The video seems preoccupied with attaching value to games solely based on their mechanics and the depth thereof, to the point of arguing Vampire Survivors is a waste of time due to its lack of depth. However, even setting aside the fact that if players are having fun then it's not time wasted, I think games can have artistic merit that supersedes the necessity of having (any / engaging / "deep") gameplay. I think the consensus online is that games are definitively art, although I could see the argument that some genres, like incremental games, might be a bit in a grey area. Let's talk about Vampire Survivors first though - It has a story to tell, with lore and many characters, that drive the player and encourage them to continue exploring the game and discovering things within it. Like any walking simulator, it is no less legitimate of a game or the "art" label because of any lack perceived lack of depth. For what it's worth, most art can be consumed with more ease than VS - any painting, movie, sculpture, etc.

A lot of incrementals have a narrative context that can similarly qualify them as art. Cookie Clicker is, as has been pointed out numerous times before, commenting on excess and increasing production beyond any reasonable limits - devolving into increasing production for its own sake. Indeed, a lot of incremental games are written to comment upon various concepts like capitalism or tropes in games, as discussed when defining Incrementals). However, I'd like to argue most incremental games are still art, even without any narrative context. "Art" as a concept is pretty nebulous already, but I personally like those who define it as an act of expression more than any physical result. The creator and the context within which they created the art, and any meaning they put into it, are all relevant and a part of the art itself. Most incremental games have artistic merit from things like why the creator made it, why they chose to make it an incremental game, and why they made any particular design decision. Hell, even if you play through an entire incremental game without a single thought or feeling, that very fact it elicited nothing can itself be artistic merit!

I'm not an art major, and I may be taking a somewhat extreme take on what is art and what has artistic merit, but I'd argue the overall point stands that games, and incremental games specifically, can have artistic merit, which appeals to many gamers.

- + \ No newline at end of file diff --git a/guide-to-incrementals/ludology/content/index.html b/guide-to-incrementals/ludology/content/index.html index bde88c05..9c6b7fa9 100644 --- a/guide-to-incrementals/ludology/content/index.html +++ b/guide-to-incrementals/ludology/content/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Guide to Incrementals/What is Content? ​

If you've been in the incremental games community for any amount of time, you'll quickly find the number one thing players want is content. They want as much of it as possible! The most popular incremental games have tons of content, so they just keep stretching on and on and on, introducing mechanic after mechanic, and players love it. In fact, players seem to value the amount of content over the quality of any specific content. However, there's a bit of a lack of understanding concerning what content is, and I'd like to explore what counts as content, and how we measure it. As a baseline definition, I think "content" can just be described as the parts of the game that engage the player, but to truly understand it we need to contextualize what that means and how it affects the gameplay experience.

To clarify the purpose of this page, my goal is not to get (too) nitpicky or to attack games with "low content". There's nothing wrong with short / low-content games - I'm quite a big fan of those games myself! This is mostly targeted toward those who ask for content and settle for "long" games, and those who want to provide content but want to make sure they're not just artificially inflating the game. Ultimately, I suppose the goal is to just reduce the amount of artificially inflated content for the sake of having a "longer" game.

Interaction ​

I think it should be a fairly non-controversial opinion that time spent solely waiting should not count towards content. That is not including the time reading various effects or making decisions in your head, but rather time spent waiting for a condition to be met so you can re-engage with the game.

That is not to say games should necessarily try to minimize this time. Plenty of games lead towards more infrequent interaction and still get popular. In fact, these games appeal to many gamers who want to have something to check up on in between bursts of working on some other activity. These games seem to have fallen slightly out of fashion amongst modern incremental games, but they're still fully valid. The point I'm trying to make here is just that this time is not content. As an extreme example, a game with no interactions and just a counter that goes up every second could safely be said to have 0 content beyond the time it takes to understand what's going on. If it has a list of "goals" to hit, then the time understanding those goals and a short time after achieving each one could be considered content, but not the idle times in between.

Let's take a look at the opposite end of the spectrum - interaction that is so frequent as to become mindless. This is any mechanic where you need to spam-click something to progress. This may be a more controversial take, but I do not believe this constitutes content either. It does not engage the player, because each consecutive click blends together and they do not individually change the gameplay experience. That is to say, a single click and 100 clicks are not meaningfully different in terms of engaging the player. I'd go as far as to say clicking 100 times would be actively worse, as it's artificially delaying the next piece of actual content, alongside the issues of accessibility and potentially causing RSI.

Repeatable Purchases ​

Imagine an entity in a game that you can purchase multiple times, each time it performs the same thing but for a higher cost. These are incredibly common, from the buildings in cookie clicker to the units in swarm sim to the IP and EP multipliers in antimatter dimensions. However, how much content is each specific purchase? Is it content beyond the first purchase? Does it have diminishing returns? What if you are oscillating between two different repeatable purchases? How much content is lost when you automate) away a repeatable purchase?

I don't want to take too harsh a stance against repeatable purchases. They're useful tools and can be used in a myriad of interesting ways. I feel they do become "stale" or less meaningful content over time, and this happens exponentially quickly the more frequently it can be purchased. A classic example that I believe goes too far is the IP/EP multipliers in Antimatter Dimensions. I would go as far as to say they are a chore and do not provide any meaningful content after you've bought them a couple of times. It's a method for inflating numbers (effectively making every OOM a 5x step instead of 10x), that punishes the player progression-wise whenever they forget to max it again, and eventually gets automated away as a reward to the player for making enough progress.

Just to voice the other side of this argument, Acamaeda defended the IP multiplier as giving the player a "good" upgrade every OOM. I can understand that to a point and need to clarify I'm mainly criticizing IP/EP multipliers after they've been introduced for a while. In fact, I would defend the multipliers for a short while after they're introduced using the same logic I would use to defend normal dimensions as repeatable purchases, at least pre-infinity. There's "content" to be had in looking at what dimensions will become affordable next, and then choosing which to buy amongst those. The IP/EP multipliers, early into infinity or eternity respectively, provide another option that gets put into that mental queue of things to buy with each OOM reached - although the optimal order is often quite trivial and not particularly engaging.

The IP/EP multipliers are not the only repeatable purchase in antimatter dimensions I take offense to. The time dimensions are also a series of repeatable purchases, that are all so similar and static that it doesn't take long before you never need to put any thought into buying them, how much you're buying at once, or the order you buy them in - you just press max all and move on. The entire tab could've been just the max all button and it would not have made a difference beyond the start of the eternity layer. The normal dimensions technically have this problem as well, but since you're constantly getting antimatter the order feels like it has a larger impact and it's more meaningful content, right up until they're automated away. Infinity dimensions are a compromise between the two, so I'm highlighting time dimensions here as the most egregious.

Following Instructions ​

We're getting more and more controversial as we go along! Let's talk about how linear content is not content now (in some circumstances). A trend in incremental games is adding difficulty by adding a web of effects that abstract the true change you can expect from any specific purchase or decision you make. If a game is both linear and sufficiently abstracts the effect of player decisions, then the player will no longer be engaging with the content - they'll simply be clicking on things as they become available. This isn't necessarily a bad thing, as plenty of players don't mind this style of gameplay, but I'd argue once you reach a point where players don't bother reading the effects, those interactions are no longer truly content. Note that unlike the previous qualifiers mentioned, this qualifier is based on the player, and therefore subjective. In effect, it's a spectrum where the more complicated the web of effects becomes, the more likely it is to disengage the player.

This over-complicatedness leading to disengaging the player can also happen from non-linear gameplay. If the web of effects becomes sufficiently complicated and finding the optimal progression route too time-consuming to discover, players will seek out guides from other players who've completed the game. The second they do this, the game effectively becomes linearly following the instructions of the guide and all the above criticisms apply. Similarly to as before, though, this is a spectrum and not everyone will seek out a guide at the same level of difficulty.

Automation

Automation is a staple of the genre, but it has certain implications for the design of the game. Why, when new content is introduced, must the older content be automated away - why is it a chore and it feels rewarding to not have to do it again? Why does the new mechanic have such appeal if we know it too will just be automated away later on, and we'll be happy when that happens? It honestly begs the question of why this framework of introducing content and automating the old content is even enjoyable - and nearly nonexistent in other genres. You're not going to reach a point in a platformer game where they just automate the jumping part - that's the core mechanic! Instead, platformers either add new mechanics that build on the core mechanic or at least re-contextualize the core mechanic. However, in incremental games new content very frequently means replacing older content, as opposed to augmenting it.

Admittedly, the above paragraph ignores the obvious answer that separates incremental games in this regard. These mechanics become chores as their frequency increases. The frequency increases to give a sense of progression, and automation is seen as a reward because it now manages what was becoming unmanageable. The new content then comes in and continues the loop to give a stronger sense of progression. That's all good and a fine justification for automating content instead of building upon the base mechanic. It's also much easier to design, as each layer essentially lets you start over instead of needing to think of ideas that conform to the original core mechanic.

So, what's the problem? Even if this trend is justified and easy to implement, there are some other effects it has on the game design. First off, and this is probably a neutral point, incremental games with this cycle of replacing old mechanics with new ones trend towards more and more abstract and further away from any narrative throughline as they add layers. There are only so many justifications for resetting progress, so if a game wants to have several of these layers they're inevitably going to become generic or increasingly loosely associated with the original content. It's most unfortunate, in my opinion when an interesting or innovative core mechanic gets fully automated once a generic "prestige" layer is unlocked.

A recent example is Really Grass Cutting Incremental, an incremental game about cutting grass (although I'm really criticizing the Roblox game it's based on). Except, it doesn't continue to be about cutting grass. After you buy enough upgrades to increase your grass cutting and level up sufficiently you "prestige", an abstract term that in this case means you reset all your progress to get some currency to buy upgrades that do the same things as the original upgrades, but these won't reset on future prestiges. You'll eventually be able to "crystallize", which means you reset all your progress to get some currency to buy upgrades that do the same things as the original upgrades (and a couple of new ones) and won't reset on future crystallizes. Fine. You'll progress a bit, complete some challenges, and finally get to... grasshop? Grasshopping is this mechanic where you reset all your progress to get some resource that isn't for buying upgrades - this time you just unlock different modifiers on everything based on their amount. You may have gotten the point by now, but there are also "steelie" resets which give you steel for some reason, before unlocking a factory with various machines - none of which are directly tied to cutting grass, and start gathering things like oil and reset for rocket parts and reset to go to space and so on and so on. Throughout all of this there is absolutely no narrative justification or throughline for the direction the game is going, or why cutting grass is still relevant when we're collecting things like rocket parts. I may be going a little hard on GCI, but it is far from alone.

Tips for Developers ​

If you're a developer, by this point you should have a pretty decent idea of how to create "true" content in your game. Here are some other specific tips I'd suggest:

An upgrade that simply unlocks another upgrade trivially isn't content. However, many games have an upgrade that just unlocks a feature, which then has a wait or other requirements before it can be used. Try to make sure when you unlock a feature, there is immediately something to do with the feature - for example, perhaps give them a small amount of the new currency it unlocks, if applicable.

If you don't have a large web of effects, and can definitively say the impact of a purchase is to multiply the gain of the cost currency by N, and the next purchase costs N times the amount of that same currency, then this purchase effectively made no difference and it may have made more sense to just go directly to the next upgrade. That said, having effects based on things like the number of purchases made will quickly invalidate this tip.

- + \ No newline at end of file diff --git a/guide-to-incrementals/ludology/definition/index.html b/guide-to-incrementals/ludology/definition/index.html index 48877439..8bc0af0d 100644 --- a/guide-to-incrementals/ludology/definition/index.html +++ b/guide-to-incrementals/ludology/definition/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Guide to Incrementals/Defining the Genre ​

Video games are placed into genres for a variety of reasons. They can give a mental shorthand to set the player's expectations up, they can help a game market itself by its similarities to other, already popular games, and honestly, people just love categorization for its own sake. For this guide, it's important to define the genre so it is clear what games it's even talking about.

This poses a problem. "Incremental" is a horribly vague way to define games. Most games have numbers going up in some form or another. We need a more specific definition - similar to how "strategy" can't just mean any game with any amount of strategy because that would be most games. What specifically differentiates incremental games from the rest?

"Incremental" implies it's a genre defined by a game mechanic, but all those game mechanics it could imply exist in many other games. Having a skill tree or upgrades doesn't make you incremental, and if a reset mechanic is all it takes then every roguelite would be an incremental as well. So clearly there's more to it than that - what makes an incremental an incremental?

I'd like to go over a couple of popular suggestions I've seen on defining the genre here. I have my personal preferences and will state them here, but I don't think there's a truly perfect answer here.

Disclaimer: I mostly play incremental games on my computer, and my definitions will be heavily biased towards the games I'm familiar with.

Incrementals vs Idlers vs Clickers ​

Oftentimes people refer to this genre as idle games and/or clicker games. You'll even find a trend of oxymoronic game titles that contain both terms. "Incremental games" is the umbrella term both those terms fall under. However, I'd like to argue that not only is it better to just use the term "incremental games", but calling them "idle games" or "clicker games" is wrong. Almost universally, these terms are used interchangeably to refer to the same kind of game, where you start the game click spamming and eventually automate the process. Frankly, that kind of game deserves neither title, and the genre of incremental games has trended away from ever requiring click spamming, as it's a bad mechanic, anyways.

While these games do span a spectrum of how active it requires you to be, and sorting games by that metric can be useful for those looking for a particular experience, the borders of when an incremental game counts as an "idler" is too blurry for the term to be useful. "Incremental games" may not be a great descriptive term for the genre (hence this many thousands of words long page on defining what the genre even is), but it's strictly better than calling them "idler" or "clicker" games. This guide will always use the term "incremental games" unless quoting someone else, as it is the term you typically see on all modern games in the genre.

Incrementals as Parodies

Let's start with one of the most interesting definitions of incremental games. Incremental games appear to be distilled versions of games or genres, "revealing" the naked game design at the core of these games or genres not unlike how parodies comment upon their source material.

To understand what that means, think of how a casino uses skinner boxes to emotionally manipulate its customers to keep playing, but "dressing" up the skinner box with tons of stimuli to hide that ultimately the goal is to condition you into coming back compulsively. The idea that incremental games are parodies means taking the stance that at some level all games are similarly manipulating you, giving dopamine rewards in a way that manipulates you to keep playing while not necessarily giving you any value or fulfillment. Incremental games, then, are any games that plainly display the skinner box, and the manipulative core of the game, at the forefront of the experience.

While incremental games can be fun and even healthy in certain contexts, they can exacerbate video game addiction more than other genres. If you feel like playing incremental games is taking priority over other things in your life, or manipulating your sleep schedule, it may be prudent to seek help. See r/StopGaming for resources.

This "undressing" tends to go hand in hand with a reduced focus on aesthetics, often just printing the game state directly to the screen as text. This makes incremental games much easier to develop, particularly for those with programming skills but not art skills, but that's a tangent for why Incremental Games Guide to Incrementals/Appeal to Developers.

Before I continue, I'd like to make my stance clear that I love games and incremental games, and do not think they should be considered inherently bad or manipulative with the above logic. Skinner boxes are just a way of manipulating behavior via rewards. The games are still fun - that's the reward! I'd believe the real criticism here is that it is "empty fun", or "empty dopamine", that doesn't offer any additional value or sense of fulfillment. I don't think that's inherently bad in moderation, although it can become a problem if the game is manipulating you for profit-seeking, or if you play the game to the detriment of the other parts of your life.

Another interpretation of incremental games as parodies comes from several mainstream incremental games that are also parodies of capitalism, such as cookie clicker and adventure capitalist. It's a very common framework for incremental games to portray the ever-increasing numbers as an insatiable hunger for resources, like the ones observed within capitalism. Therefore, these games are used as evidence that the genre as a whole is about parody and commentary.

Popular videos on incremental games that portray the genre as parodies are Why Idle games make good satire, and how it was ruined. and Bad Game Design - Clicker Games. You may also be interested in this response to the latter video from a fan of incremental games: BadGood Game Design - Clicker Games.

I think that this definition ultimately ascribes a motive to the genre as a whole that only happens to apply to some of the more mainstream titles. There certainly are incremental games commenting on different things, including the genre itself as in the case of The Prestige Tree Classic, The Ascension Tree, or Omega Layers, but certainly not all. And of course, not all games that comment on something or parody something are incremental games! Additionally, a very large majority of incremental games are mobile games using these manipulative strategies to get players to spend as much money as possible - hell, Adventure Capitalist is ostensibly a critique on capitalism but features microtransactions and gameplay that manipulates you into buying them! These profit-seeking incremental games certainly belong within the genre but are hardly parodies when they too use manipulation to serve their interests. Also, from my own anecdotal experience, those who use this definition seem to do so from a fairly surface-level familiarity with the genre, and often in the context of criticizing the genre or the fans thereof.

Incrementals as NGU ​

Another broad definition often used is that incremental games are games where the focus of the game is "numbers going up". This definition proposes that other genres simply use increasing numbers as a means to an end, but incremental games uniquely only care about the numbers themselves going up. Put another way, it implies there should be no narrative justification for the numbers going up other than "why shouldn't they be going up?"

While this definition is common because it feels easy to understand, it is difficult to formally define. Often phrases are used to describe games using this framework, such as having an "exaggerated sense of progression" or "big" numbers. These terms are vague and don't demonstrate an actual threshold between non-incrementals and incrementals. Most games have a sense of progression, so when is it "exaggerated"? How big are "big" numbers? Most notably, RPGs that are typically not considered incrementals will often pass this definition.

Additionally, a lot of incrementals tend to have some theme guiding the gameplay, or at least the names of mechanics. This makes the line blurred between when numbers are going up for their own sake versus for a contextual reason. I believe this point is best illustrated that, while most RPGs are not considered incremental games, there is a sub-genre of "incremental RPGs" that typically relates to RPGs that perform combat automatically. This definition of incremental games does not support RPGs and "incremental RPGs" being on distinct sides of the line if the only difference between them is manual vs automatic combat.

Incrementals as Strategies

This is a rarer interpretation, but there are similarities between incremental games and strategy games, implying incrementals might just be a sub-genre of strategy games. By this approach, incremental games would be defined by their relation to strategy games, and how they involve player strategy. Incremental games are often large optimization problems - above all else, the actual gameplay the player is performing is deciding what to do next. The consequences of wrong decisions are typically more lenient in incremental games - such as just not making optimal progress - but they certainly get complex.

So if we accept the premise that incrementals could fall under strategy, we still need to define what makes a strategy game an incremental versus some other strategy sub-genre. This is a bit tricky due to one particular sub-genre of strategy games: Factory Builders.

Factory builders, such as Factorio or Satisfactory, are games about gaining ever increasing resources, optimizing production, and expanding more and more. That... sounds pretty similar, doesn't it? In fact, there's been some debate on whether factory builders would fall under the "incremental" umbrella. I think it's safe to say the two are certainly related, and probably have quite a bit of overlap in playerbase.

Roguelites as Incrementals? ​

Earlier on, I mentioned reset mechanics shouldn't be used in the definition because that could make all roguelites incrementals... But what if it does? A lot of incrementals can be described as games with a strong sense of progression, often with layers of meta-progression. Roguelites fit that bill to a T. What would make roguelites not incremental? I honestly don't think there's a good explanation here, but many fans of incremental games will state they do believe the two genres to be unrelated, even if there's a significant overlap between their player bases due to having similar appealing traits.

At this point, it'd be appropriate to consider what part of the definition of roguelites precludes them from also being incrementals, but that reveals a new problem: What are roguelites? They're usually defined as rogue_likes with meta-progression, but that just pushes the problem back a step: Incrementals aren't the only genre to have difficulties defining themselves, it seems! Roguelikes are another genre where the community argues over the formal definition of their genre, although that means we can borrow from their process of coming to a consensus, and maybe come across a viable definition for incremental games.

The Berlin Interpretation ​

By far the most popular way of defining roguelikes is the "Berlin Interpretation", which acknowledged the diversity of games within the genre and argued the definition should not be based on any ideals about what the genre ought to be, but rather defined by "its canon". They argued there are a handful of games that can be used to define the canon for roguelikes, and from those games, a list of factors can be derived to determine a game's "roguelikeness". The more factors a game has, the more of a roguelike it is. This strategy is very lenient, allowing a game to not present any specific factor so long as it shows enough, and accounts for the blurriness of any genre definition by not explicitly stating how many factors a game must have to qualify as a definite roguelike.

I believe this strategy for defining genres can be applied to other genres as well. A handful of games can be argued to be the incremental games canon, and a list of factors derived from them can be used to judge any game based on its "incrementalness". I'll propose such a canon and list of factors here, but by no means should it be considered the end-all-be-all.

Note: The "Temple of the roguelike", an authority within the genre, has since replaced the Berlin Interpretation with a new set of factors here: https://blog.roguetemple.com/what-is-a-traditional-roguelike/

The Incremental Games Canon ​

Alright, time to get controversial. Up til now, I've been trying my best to stay objective and analytical, but now it's time to start making some opinionated decisions. Here is a list of games I think could justifiably make up an Incremental Games Canon:

I chose a variety of games here, biasing towards newer games, purposefully to avoid making a narrow or "traditional" definition. The genre is growing and shouldn't be constrained by the traits of the early popular titles. A lot of these could easily be replaced with other games that are mechanically congruent, so ultimately I'm sure if you asked 10 people for their canon list you'd just get 10 different answers, but I think this should sufficiently allow us to determine what factors make a game have higher "incrementalness".

The Paradigm Shift ​

The Paradigm Shift is probably the highest possible value factor for an incremental. It's so common that for a while people referred to incrementals that exhibit this trait as "unfolding" games, to the point of trying to replace the term incremental due to their popularity. Paradigm shifts refer to when the gameplay significantly changes. There are too many examples to list here, but notably, every single reset mechanic is typically going to be a paradigm shift. Examples of games with paradigm shifts that aren't tied to reset mechanics include Universal Paperclips and A Dark Room.

There are many reasons for the appeal of paradigm shifts. Oftentimes each mechanic builds on top of the existing mechanics, increasing the complexity of the game in steps so the player can follow along. They provide a sense of mystery, with the player anticipating what will happen next. They shake up the gameplay before it gets too stale - allowing the game to entertain for longer before the sense of Guide to Incrementals/What is Content? dissipates. Of the canon games selected above, I would argue every single one contains a paradigm shift (although I could see someone disagreeing with that statement wrt Increlution).

I should take a moment to say that while I'm hyping up this specific factor, we cannot just reduce the genre definition to "does it have paradigm shifts". Many games have paradigm shifts that are not incremental, so it's just an indicator of incrementalness. Additionally, it can become quite hard to determine how large of a shift is a "paradigm" shift. Take, for example, any game with a skill tree. In some games, each skill node might have a large impact on how you play with the game, and qualify as a paradigm shift for some players. In other games, each skill node might just be a small percentage modifier on some stat that doesn't really impact much more than a slight bias towards an already established mechanic that's newly buffed. Every single canon game may show that it's common amongst incremental games, but could just as easily indicate that they're common in games in general.

High-Value Factors ​

I won't take as long to discuss the high and low-value factors, as you've already seen most of them brought up earlier on this page. As a reminder, a game does NOT need all of these to be an incremental game, but these are factors that each indicate a strong possibility the game is an incremental, so having several of these means they probably are. These factors apply to most of the canon incremental games.

"Pure UI" Display. Incrementals typically have a textual presentation of the game state - there isn't a visual representation of the entities within the game. The interface is closer to what would be just the UI of a game in another genre or the control panel of a plane. If there is a visual representation, the player is often still interacting with non-diegetic game elements.

Reduced Consequences. Incrementals tend to have reduced repurcussions for misplaying. They very rarely have fail states, where often the largest consequence is simply not progressing - never losing progress.

Optimization Problems. The predominant gameplay of incrementals is typically solving optimization problems, from deciding which purchase to save up for to reasoning and deciding between different mutually exclusive options the game presents.

Resource Management. Incrementals tend to have a lot of resources within the game to keep track of.

Low-Value Factors ​

These are low-value factors, meaning they aren't as strongly correlated with incremental games. Incremental games may have none of these, and non-incrementals may have several of these - if a game only has low-value factors, they're probably not an incremental.

Fast Numeric Growth. Numbers in incremental games tend to grow faster than in other genres. There are more instances of superlinear growth. The larger the numbers get, the stronger of a signal this factor is.

Automation. As an incremental game progresses, the player often no longer has to deal with earlier mechanics, by having them either happen automatically or otherwise be replaced with an alternative that requires less player interaction.

Goal-Oriented. Incrementals are often heavily reliant on extrinsic motivation to guide the player. Typically this is through some sort of in-game goal to work towards, such as a certain amount of a resource being required to unlock or purchase something new.

Waiting is a Mechanic. In incremental games, the player may come across times where there is no action they can take, and the game will progress automatically instead. The player must wait for some amount of this automatic progress to occur before they can resume interaction with the game.

Are Roguelites Incrementals? ​

Having made our variation of the Berlin Interpretation for incremental games, we can compare it to the Berlin Interpretation to determine if there's enough overlap that any game that "passes" the Berlin Interpretation would also pass the incremental variant. That is to say, whether any roguelite would also be considered an incremental game.

The meta-progression of an incremental game could arguably be considered a paradigm shift, and certainly adds some resource management. Goal-oriented would probably also apply. I think anything other than those would be a stretch, and in my opinion that just isn't enough to qualify. To be totally honest, I was never expecting to conclude otherwise though 😉

Sub-Genres ​

There are some trends in incremental games that go beyond just being a commonly used mechanic, such that they deeply affect the rest of the game design. These trends can be used to determine sub-genres within the incremental games umbrella:

Loops games are a sub-genre defined by having a core mechanic related to a loop, where the player is deciding the actions taken per loop. Notable examples include Idle Loops, Stuck in Time, Cavernous II, and Increlution. You may also argue Groundhog Life and Progress Knight fall into this sub-genre.

ITRTG-like games are a sub-genre defined by having a core mechanic based on clearing increasingly difficult battles and often tend to have a lot of different mechanics to become progressively stronger. Notable examples include Idling to Rule the Gods, NGU Idle, and Wizard and Minion Idle.

Polynomial Growth games are a sub-genre defined by having a core mechanic related to a higher degree polynomial. Notable examples include the base layer of Antimatter Dimensions and Swarm Simulator.

Upgrades Games is a category popular on flash games websites that featured games focused on buying upgrades that would allow you to attain more currency in some sort of minigame that would earn you more money to buy more upgrades, which I'd argue now belong under the fold of incremental games. Notable examples include the Learn to Fly series and Upgrade Complete.

Cultivation RPGs are a genre of games, books, and anime popular in China that center around being in a fantasy world with characters getting stronger over time. While few of them get translated into English, a fan of incremental games may find the available games interesting.

- + \ No newline at end of file diff --git a/hashmap.json b/hashmap.json index a865dcd7..3050ac76 100644 --- a/hashmap.json +++ b/hashmap.json @@ -1 +1 @@ -{"garden_davey-wreden_index.md":"BMlE9hYd","garden_decentralized_index.md":"DuxiPg9M","garden_babble-buds_index.md":"IVJV-9eu","garden_dice-armor_index.md":"CztXuY1B","garden_fediverse_index.md":"UJiYbaK2","garden_advent-incremental_index.md":"Bi867NSD","garden_vitepress_index.md":"6SyjaoK2","garden_planar-pioneers_index.md":"DjRmOjdq","garden_freeform-vs-chronological-dichotomy_index.md":"C3LSUlA6","garden_the-beginner-s-guide_index.md":"vCAvuQfF","garden_synapse_index.md":"DlkipkaT","garden_this-knowledge-hub_index.md":"BtDJLJGY","garden_freeform_index.md":"BLA-ZZ3B","garden_guide-to-incrementals_appeal-to-developers_index.md":"C6gNawcM","garden_garden-rss_index.md":"CqqLm4uJ","garden_game-dev-tree_index.md":"DweE1Ysy","garden_guide-to-incrementals_what-is-content_index.md":"A83vET_y","guide-to-incrementals_index.md":"DKlWf0lO","garden_guide-to-incrementals_index.md":"D-Qo_phb","garden_my-personal-website_index.md":"DryeDwGD","garden_nostr_index.md":"CnVfHGYc","guide-to-incrementals_ludology_appeal-developers_index.md":"B3Lh8HIP","garden_capture-the-citadel_index.md":"CcwwplwM","garden_my-projects_index.md":"efagz0SF","garden_mbin_index.md":"DHRumvWR","changelog_index.md":"ApjhnUUz","garden_kronos_index.md":"B-JAOjIb","public_kronos_docs_main-mod-info.md":"59FtHiDt","public_kronos_docs_challenges.md":"xjts-SLB","public_kronos_docs_infoboxes.md":"d7yspWU6","public_kronos_docs_clickables.md":"CwRD8HLA","public_kronos_docs_custom-tab-layouts.md":"DQLQaGen","public_kronos_docs_layer-features.md":"CUYPvQ75","public_kronos_docs_getting-started.md":"CvyktqWn","public_kronos_docs_grids.md":"D6eGDxZf","garden_the-cozy-web_index.md":"C9yKvylk","public_kronos_docs_bars.md":"DYrBr3p3","public_gamedevtree_changelog.md":"BVckBzUe","public_gamedevtree_docs_!general-info.md":"WzWHA4Zz","public_gamedevtree_readme.md":"D0kWmw3r","public_gamedevtree_docs_achievements.md":"BgY9AsGa","public_gamedevtree_docs_bars.md":"DbswOg3L","garden_weird_index.md":"Bd7l3f9l","garden_matrix_index.md":"B4VZfP7W","garden_open-source_index.md":"DFsY5O5E","public_gamedevtree_docs_buyables.md":"Bu_8Had0","public_gamedevtree_docs_getting-started.md":"CO6xRZs4","public_gamedevtree_docs_challenges.md":"BFQDD4X0","public_gamedevtree_docs_clickables.md":"9UR7Ajqa","public_gamedevtree_docs_infoboxes.md":"CRUxoh5g","public_gamedevtree_docs_custom-tab-layouts.md":"CuvyVAhF","public_gamedevtree_docs_layer-features.md":"DSg6NDQu","garden_cinny_index.md":"DjdgGx9N","public_lit_docs_main-mod-info.md":"DgSHm7mV","garden_digital-gardens_index.md":"ChW8RG51","garden_forgejo_index.md":"BIFTMSC0","garden_social-media_index.md":"CZWs3kNq","garden_federated-identity_index.md":"Bf4QWuIq","garden_atproto_index.md":"BwFHx7Hd","garden_guide-to-incrementals_appeal-to-players_index.md":"AIc2QesW","garden_ivy-road_index.md":"DK8swC5I","garden_opti-speech_index.md":"C1FMxL_Q","garden_commune_index.md":"Cz6o7qRH","garden_the-small-web_index.md":"2RHAQRcF","garden_profectus_index.md":"0UR_Gmo7","public_lit_docs_subtabs-and-microtabs.md":"BRlF9GbR","garden_chronological_index.md":"g8ZA0BlN","public_gamedevtree_docs_subtabs-and-microtabs.md":"C4QzwvQW","guide-to-incrementals_ludology_appeal-gamers_index.md":"CjswzOO0","public_kronos_readme.md":"DOcyAoHv","public_kronos_docs_milestones.md":"_qurRXy3","public_lit_readme.md":"pVsJJuH2","public_kronos_docs_buyables.md":"Clz5ovuw","public_lit_docs_basic-layer-breakdown.md":"CZbO_awH","public_lit_docs_trees-and-tree-customization.md":"B4CePdZ2","public_kronos_docs_updating-tmt.md":"F3HiFsfM","index.md":"DdYa43X-","public_lit_docs_bars.md":"B1zVageA","garden_guide-to-incrementals_defining-the-genre_index.md":"B-EmqxPI","public_gamedevtree_docs_updating-tmt.md":"DGbxasx9","public_lit_docs_!general-info.md":"Bx73xrHN","garden_chat-glue_index.md":"Cgbw8xnx","public_lit_docs_achievements.md":"Cz8mR7W2","public_gamedevtree_docs_basic-layer-breakdown.md":"DlASwD5Q","public_gamedevtree_docs_upgrades.md":"DZ8OZlWu","public_gamedevtree_2.0-format-changes.md":"Cu7Ykz4Q","public_kronos_docs_trees-and-tree-customization.md":"DNSPCGw2","garden_guide-to-incrementals_navigating-criticism_index.md":"Djt_EVT5","public_lit_docs_milestones.md":"Cty1k_dD","public_lit_changelog.md":"O4pzFPx8","garden_logseq_index.md":"Sw_XpNVJ","public_lit_docs_infoboxes.md":"rD48WYz9","public_kronos_docs_achievements.md":"CV5RQN-f","public_kronos_docs_particles.md":"BmR47K5y","public_lit_docs_getting-started.md":"GyuAnbTP","public_lit_docs_clickables.md":"XlVpmgOb","garden_wanderstop_index.md":"fcx7CNrA","guide-to-incrementals_ludology_definition_index.md":"DKOCC4rn","public_kronos_changelog.md":"CKFBbvc8","garden_incremental-social_index.md":"TlaPPmQO","public_kronos_docs_subtabs-and-microtabs.md":"NAJvWyOX","public_lit_docs_buyables.md":"BSNB4_NL","public_lit_docs_custom-tab-layouts.md":"RNFGijzw","guide-to-incrementals_ludology_content_index.md":"DrX3RUub","garden_activitypub_index.md":"BKxKk1GM","public_lit_docs_layer-features.md":"B06xG5cR","garden_webrings_index.md":"57x1ZkEg","garden_v-ecs_index.md":"CeXiyFwA","public_lit_docs_updating-tmt.md":"Bx5ufyRr","guide-to-incrementals_design_criticism_index.md":"f96IunmV","public_gamedevtree_docs_milestones.md":"BmAGhs_0","public_kronos_docs_upgrades.md":"CwGnjpZF","garden_fedi-v2_index.md":"B5ZguLke","public_kronos_docs_basic-layer-breakdown.md":"CKcXGVzo","public_lit_docs_upgrades.md":"Bh4bFGTK","public_gamedevtree_docs_main-mod-info.md":"6LyBs-t5","public_kronos_docs_!general-info.md":"BpKUMbLF","public_lit_docs_challenges.md":"Ckyne6Wg","public_lit_old things_2.0-format-changes.md":"C-yzF1yi","public_kronos_old things_2.0-format-changes.md":"NRns2BBm"} +{"garden_capture-the-citadel_index.md":"CcwwplwM","changelog_index.md":"ApjhnUUz","garden_advent-incremental_index.md":"Bi867NSD","garden_mbin_index.md":"DHRumvWR","public_kronos_docs_upgrades.md":"CwGnjpZF","public_kronos_docs_bars.md":"DYrBr3p3","public_lit_docs_buyables.md":"BSNB4_NL","public_kronos_docs_basic-layer-breakdown.md":"CKcXGVzo","public_kronos_docs_clickables.md":"CwRD8HLA","public_kronos_docs_buyables.md":"Clz5ovuw","garden_activitypub_index.md":"BKxKk1GM","public_lit_old things_2.0-format-changes.md":"C-yzF1yi","public_kronos_docs_getting-started.md":"CvyktqWn","public_kronos_docs_grids.md":"D6eGDxZf","public_kronos_docs_trees-and-tree-customization.md":"DNSPCGw2","public_kronos_docs_updating-tmt.md":"F3HiFsfM","public_lit_docs_clickables.md":"XlVpmgOb","public_lit_docs_custom-tab-layouts.md":"RNFGijzw","public_lit_docs_getting-started.md":"GyuAnbTP","public_lit_docs_challenges.md":"Ckyne6Wg","public_lit_docs_layer-features.md":"B06xG5cR","public_lit_docs_main-mod-info.md":"DgSHm7mV","public_gamedevtree_docs_challenges.md":"BFQDD4X0","public_gamedevtree_docs_custom-tab-layouts.md":"CuvyVAhF","public_gamedevtree_docs_clickables.md":"9UR7Ajqa","public_lit_docs_infoboxes.md":"rD48WYz9","public_gamedevtree_docs_layer-features.md":"DSg6NDQu","public_gamedevtree_docs_milestones.md":"BmAGhs_0","public_gamedevtree_docs_subtabs-and-microtabs.md":"C4QzwvQW","public_gamedevtree_docs_updating-tmt.md":"DGbxasx9","public_gamedevtree_docs_main-mod-info.md":"6LyBs-t5","public_gamedevtree_docs_upgrades.md":"DZ8OZlWu","public_gamedevtree_docs_infoboxes.md":"CRUxoh5g","public_gamedevtree_docs_getting-started.md":"CO6xRZs4","public_kronos_readme.md":"DOcyAoHv","public_kronos_docs_!general-info.md":"BpKUMbLF","public_kronos_docs_achievements.md":"CV5RQN-f","public_lit_docs_achievements.md":"Cz8mR7W2","public_lit_changelog.md":"O4pzFPx8","public_lit_docs_!general-info.md":"Bx73xrHN","garden_the-small-web_index.md":"2RHAQRcF","garden_federated-identity_index.md":"Bf4QWuIq","public_lit_docs_bars.md":"B1zVageA","public_lit_docs_basic-layer-breakdown.md":"CZbO_awH","garden_fedi-v2_index.md":"B5ZguLke","garden_fediverse_index.md":"UJiYbaK2","garden_freeform-vs-chronological-dichotomy_index.md":"C3LSUlA6","garden_forgejo_index.md":"BIFTMSC0","garden_game-dev-tree_index.md":"DweE1Ysy","garden_freeform_index.md":"BLA-ZZ3B","garden_garden-rss_index.md":"CqqLm4uJ","garden_guide-to-incrementals_appeal-to-developers_index.md":"C6gNawcM","garden_guide-to-incrementals_appeal-to-players_index.md":"AIc2QesW","garden_guide-to-incrementals_defining-the-genre_index.md":"B-EmqxPI","garden_synapse_index.md":"DlkipkaT","garden_guide-to-incrementals_what-is-content_index.md":"A83vET_y","garden_weird_index.md":"Bd7l3f9l","guide-to-incrementals_design_criticism_index.md":"f96IunmV","guide-to-incrementals_index.md":"DKlWf0lO","guide-to-incrementals_ludology_appeal-developers_index.md":"B3Lh8HIP","guide-to-incrementals_ludology_appeal-gamers_index.md":"CjswzOO0","guide-to-incrementals_ludology_definition_index.md":"DKOCC4rn","public_gamedevtree_readme.md":"D0kWmw3r","garden_my-projects_index.md":"efagz0SF","public_gamedevtree_2.0-format-changes.md":"Cu7Ykz4Q","garden_this-knowledge-hub_index.md":"BtDJLJGY","index.md":"DdYa43X-","garden_chat-glue_index.md":"Cgbw8xnx","guide-to-incrementals_ludology_content_index.md":"DrX3RUub","garden_open-source_index.md":"DFsY5O5E","public_lit_readme.md":"pVsJJuH2","public_lit_docs_updating-tmt.md":"Bx5ufyRr","public_lit_docs_subtabs-and-microtabs.md":"BRlF9GbR","public_lit_docs_trees-and-tree-customization.md":"B4CePdZ2","garden_incremental-social_index.md":"TlaPPmQO","public_lit_docs_upgrades.md":"Bh4bFGTK","public_kronos_docs_infoboxes.md":"d7yspWU6","garden_profectus_index.md":"0UR_Gmo7","garden_social-media_index.md":"CZWs3kNq","garden_the-beginner-s-guide_index.md":"vCAvuQfF","public_kronos_docs_layer-features.md":"CUYPvQ75","garden_the-cozy-web_index.md":"C9yKvylk","public_kronos_docs_main-mod-info.md":"59FtHiDt","public_kronos_docs_subtabs-and-microtabs.md":"NAJvWyOX","public_kronos_docs_challenges.md":"xjts-SLB","garden_v-ecs_index.md":"CeXiyFwA","garden_guide-to-incrementals_index.md":"D-Qo_phb","garden_vitepress_index.md":"6SyjaoK2","public_gamedevtree_changelog.md":"BVckBzUe","public_gamedevtree_docs_achievements.md":"BgY9AsGa","public_gamedevtree_docs_bars.md":"DbswOg3L","garden_babble-buds_index.md":"IVJV-9eu","garden_atproto_index.md":"BwFHx7Hd","garden_matrix_index.md":"B4VZfP7W","garden_webrings_index.md":"57x1ZkEg","garden_wanderstop_index.md":"fcx7CNrA","garden_ivy-road_index.md":"DK8swC5I","garden_dice-armor_index.md":"CztXuY1B","public_kronos_docs_particles.md":"BmR47K5y","garden_logseq_index.md":"Sw_XpNVJ","garden_guide-to-incrementals_navigating-criticism_index.md":"Djt_EVT5","garden_kronos_index.md":"B-JAOjIb","public_gamedevtree_docs_buyables.md":"Bu_8Had0","garden_planar-pioneers_index.md":"DjRmOjdq","public_kronos_docs_milestones.md":"_qurRXy3","public_kronos_changelog.md":"CKFBbvc8","garden_digital-gardens_index.md":"ChW8RG51","public_kronos_docs_custom-tab-layouts.md":"DQLQaGen","garden_cinny_index.md":"DjdgGx9N","garden_commune_index.md":"Cz6o7qRH","garden_chronological_index.md":"g8ZA0BlN","public_kronos_old things_2.0-format-changes.md":"NRns2BBm","garden_decentralized_index.md":"DuxiPg9M","public_lit_docs_milestones.md":"Cty1k_dD","public_gamedevtree_docs_!general-info.md":"WzWHA4Zz","public_gamedevtree_docs_basic-layer-breakdown.md":"DlASwD5Q","garden_opti-speech_index.md":"C1FMxL_Q","garden_davey-wreden_index.md":"BMlE9hYd","garden_nostr_index.md":"CnVfHGYc","garden_my-personal-website_index.md":"DryeDwGD"} diff --git a/index.html b/index.html index 6ecfc7d5..936f1419 100644 --- a/index.html +++ b/index.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@
- + \ No newline at end of file diff --git a/public/gamedevtree/2.0-format-changes.html b/public/gamedevtree/2.0-format-changes.html index 3ac507bf..f4f29cad 100644 --- a/public/gamedevtree/2.0-format-changes.html +++ b/public/gamedevtree/2.0-format-changes.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

2.0 format changes ​

  • Temp format is changed from temp.something[layer] to temp[layer].something, for consistency
  • Challenges are now saved as an object with the amount of completions in each spot. (This will break saves.)
  • effectDisplay in Challenges and Upgrades no longer takes an argument, and neither does effect for Buyables
  • Buyable cost can take an argument for amount of buyables, but it needs to function if no argument is supplied (it should do the cost for the next purchase).
  • Generation of Points now happens in the main game loop (not in a layer update function), enabled by canGenPoints in game.js.
  • Changed fullLayerReset to layerDataReset, which takes an array of names of values to keep

In addition, many names were changed, mostly expanding abbreviations:

All instances of:

  • chall -> challenge
  • unl -> unlocked
  • upg -> upgrade (besides CSS)
  • amt -> amount
  • desc -> description
  • resCeil -> roundUpCost
  • order -> unlockOrder
  • incr_order -> increaseUnlockOrder

Challenges:

  • desc -> challengeDescription
  • reward -> rewardDescription
  • effect -> rewardEffect
  • effectDisplay -> rewardDisplay
  • active -> challengeActive
- + \ No newline at end of file diff --git a/public/gamedevtree/README.html b/public/gamedevtree/README.html index d7913fdb..ddc92a33 100644 --- a/public/gamedevtree/README.html +++ b/public/gamedevtree/README.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

The-Modding-Tree ​

A modified version of The Prestige Tree that is much easier to mod. It still requires programming knowledge, but it's mostly pretty easy things and copy/pasting.

Look here for a tutorial on getting started with modding with TMT

You can look in the documentation for more information on how it all works, or look at the code in layers.js to see what it all looks like.

- + \ No newline at end of file diff --git a/public/gamedevtree/changelog.html b/public/gamedevtree/changelog.html index 0a6bf138..2781c63b 100644 --- a/public/gamedevtree/changelog.html +++ b/public/gamedevtree/changelog.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

The Game Dev Tree changelog: ​

v1.0.4 Version Bump [rebalanced,debuggedx3] - 2020-11-09 ​

  • Fixed refactorings 2, 3, and 4 not actually affecting productivity

v1.0.3 Version Bump [rebalanced,debuggedx2] - 2020-11-08 ​

  • Fixed API milestone 4 not working

v1.0.2 Version Bump [rebalanced,debugged] - 2020-11-08 ​

  • Fixed tree lines being hidden after hitting "keepGoing" in the victory screen

v1.0.1 Version Bump [rebalanced] - 2020-11-08 ​

  • Buffed several TAs

v1.0 Version Bump - 2020-11-08 ​

  • Finished row 4
  • Added colored text to lore
  • Fixed some visual bugs with milestones
  • Probably other stuff lol its been a week

v0.2.3 Stylish - 2020-10-30 ​

  • Re-styled basically everything
  • Added favicon
  • Added header bar
  • Added changelog

v0.2.2 Row 3 - 2020-10-22 ​

  • Removed debug statement
  • Moved milestones in F layer beneath the buyables

v0.2.1 Row 3 - 2020-10-21 ​

  • Fixed layers hiding
  • Fixed typos/minor issues
  • Fixed S layer being highlighted before you can unlock the layer

v0.2 Row 3 - 2020-10-21 ​

  • Implemented row 3

v0.1.1 Cash Influx [rebalanced] - 2020-10-19 ​

  • Fixed notification issue
  • Rebalanced to make early game faster and late game slower
  • Fixed other minor issues

v0.1 Cash Influx - 2020-10-19 ​

  • Implemented row 2

v0.0 Initial Commit - 2020-10-18 ​

  • Implemented row 1
- + \ No newline at end of file diff --git a/public/gamedevtree/docs/!general-info.html b/public/gamedevtree/docs/!general-info.html index b814b51c..0879a008 100644 --- a/public/gamedevtree/docs/!general-info.html +++ b/public/gamedevtree/docs/!general-info.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

The-Modding-Tree ​

The main way to add content is through creating layers. You can either add a layer directly in the layers object in layersSupportjs, or declare it in another file and then do "addLayer(layername, layerdata)" (good for breaking things up into smaller files). The existing layers are just examples and can be freely deleted. You can also use them as references and a base for your own layers.

The first thing you need to do is to edit the modInfo at the top of game.js to set your modID (a string). A unique modId will prevent your mod's saves from conflicting with other mods.

Most of the time, you won't need to dive deep into the code to create things, but you still can if you really want to.

The Modding Tree uses break_eternity.js to store large values. This means that many numbers are Decimal objects, and must be treated differently. For example, you have to use new Decimal(x) to create a Decimal value instead of a plain number, and perform operations on them by calling functions. e.g, instead of x = x + y, use x = x.add(y).

Almost all values can be either a constant value, or a dynamic value. Dynamic values are defined by putting a function that returns what the value should be at any given time.

All display text can be basic HTML instead (But you can't use most Vue features there).

Table of Contents: ​

General: ​

  • Getting Started: Getting your own copy of the code set up with Github Desktop.
  • Main mod info: How to set up general things for your mod in mod.js.
  • Basic layer breakdown: Breaking down the components of a layer with minimal features.
  • Layer features: Explanations of all of the different properties that you can give a layer.
  • Custom Tab Layouts: An optional way to give your tabs a different layout. You can even create entirely new components to use.
  • Updating TMT: Using Github Desktop to update your mod's version of TMT.

Common components ​

  • Upgrades: How to create upgrades for a layer.
  • Milestones: How to create milestones for a layer.
  • Buyables: Create rebuyable upgrades for your layer (with the option to make them respec-able). Can be used to make Enhancers or Space Buildings.
  • Clickables: A more generalized variant of buyables, for any kind of thing that is sometimes clickable. Between these and Buyables, you can do just about anything.

Other components ​

  • Challenges: How to create challenges for a layer.
  • Bars: Display some information as a progress bar, gague, or similar. They are highly customizable, and can be horizontal and vertical as well.
  • Subtabs and Microtabs: Create subtabs for your tabs, as well as "microtab" components that you can put inside the tabs.
  • Achievements: How to create achievements for a layer (or for the whole game).
  • Infoboxes: Boxes containing text that can be shown or hidden.
- + \ No newline at end of file diff --git a/public/gamedevtree/docs/achievements.html b/public/gamedevtree/docs/achievements.html index 63bd2f1a..67576181 100644 --- a/public/gamedevtree/docs/achievements.html +++ b/public/gamedevtree/docs/achievements.html @@ -8,10 +8,10 @@ - + - + @@ -318,7 +318,7 @@ } etc }

Each achievement should have an id where the first digit is the row and the second digit is the column. Individual achievement can have these features:

  • name: optional, displayed at the top of the achievement. The only visible text. It can also be a function that returns updating text. Can use basic HTML.

  • done(): A function returning a boolean to determine if the achievement should be awarded.

  • tooltip: Default tooltip for the achievement, appears when it is hovered over. Should convey the goal and any reward for completing the achievement. It can also be a function that returns updating text. Can use basic HTML.

  • effect(): optional, A function that calculates and returns the current values of any bonuses from the achievement. Can return a value or an object containing multiple values.

  • unlocked(): optional, A function returning a bool to determine if the achievement is visible or not. Default is unlocked.

  • onComplete() - optional, this function will be called when the achievement is completed.

  • style: Optional, Applies CSS to this achievement, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings)

  • layer: Assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar

  • id: Assigned automagically. It's the "key" which the achievement was stored under, for convenient access. The achievement in the example's id is 11.

  • goalTooltip: optional, depracated Appears when the achievement is hovered over and locked, overrides the basic tooltip. This is to display the goal (or a hint). It can also be a function that returns updating text. Can use basic HTML.

  • doneTooltip: optional, depracated Appears when the achievement is hovered over and completed, overrides the basic tooltip. This can display what the player achieved (the goal), and the rewards, if any. It can also be a function that returns updating text. Can use basic HTML.

- + \ No newline at end of file diff --git a/public/gamedevtree/docs/bars.html b/public/gamedevtree/docs/bars.html index 915f9a6d..8728792e 100644 --- a/public/gamedevtree/docs/bars.html +++ b/public/gamedevtree/docs/bars.html @@ -8,10 +8,10 @@ - + - + @@ -316,7 +316,7 @@ } etc }

Features:

  • direction: UP, DOWN, LEFT, or RIGHT (not Strings). Determines the direction that the bar is filled as it progresses. RIGHT means from left to right.

  • width, height: The size in pixels of the bar, but as Numbers (no "px" at the end)

  • progress(): A function that returns the portion of the bar that is filled, from "empty" at 0 to "full" at 1. (Nothing bad happens if the value goes out of these bounds, and it can be a number or Decimal).

  • display(): optional, A function that returns text to be displayed on top of the bar, can use HTML.

  • unlocked(): optional, A function returning a bool to determine if the bar is visible or not. Default is unlocked.

  • baseStyle, fillStyle, borderStyle, textStyle: Optional, Apply CSS to the unfilled portion, filled portion, border, and display text on the bar, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • layer: Assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar

  • id: Assigned automagically. It's the "key" which the bar was stored under, for convenient access. The bar in the example's id is "bigBar".

- + \ No newline at end of file diff --git a/public/gamedevtree/docs/basic-layer-breakdown.html b/public/gamedevtree/docs/basic-layer-breakdown.html index 2f750aee..8b473a87 100644 --- a/public/gamedevtree/docs/basic-layer-breakdown.html +++ b/public/gamedevtree/docs/basic-layer-breakdown.html @@ -8,10 +8,10 @@ - + - + @@ -337,7 +337,7 @@ layerShown() {return true}, // Returns a bool for if this layer's node should be visible in the tree. }, - + \ No newline at end of file diff --git a/public/gamedevtree/docs/buyables.html b/public/gamedevtree/docs/buyables.html index dd4f876b..91cd7664 100644 --- a/public/gamedevtree/docs/buyables.html +++ b/public/gamedevtree/docs/buyables.html @@ -8,10 +8,10 @@ - + - + @@ -323,7 +323,7 @@ } etc }

Features:

  • title: optional, displayed at the top in a larger font It can also be a function that returns updating text.

  • cost(): cost for buying the next buyable. Can have an optional argument "x" to calculate the cost of the x+1th object, but needs to use "current amount" as a default value for x. (x is a Decimal). Can return an object if there are multiple currencies.

  • effect(): optional, A function that calculates and returns the current values of bonuses of this buyable. Can return a value or an object containing multiple values.

  • display(): A function returning everything that should be displayed on the buyable after the title, likely including the description, amount bought, cost, and current effect. Can use basic HTML.

  • unlocked(): optional, A function returning a bool to determine if the buyable is visible or not. Default is unlocked.

  • canAfford(): A function returning a bool to determine if you can buy one of the buyables.

  • buy(): A function that implements buying one of the buyable, including spending the currency.

  • buyMax(): optional, A function that implements buying as many of the buyable as possible.

  • style: Optional, Applies CSS to this buyable, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings)

  • layer: Assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar

  • id: Assigned automagically. It's the "key" which the buyable was stored under, for convenient access. The buyable in the example's id is 11.

Sell One/Sell All:

Including a sellOne or sellAll function will cause an additional button to appear beneath the buyable. They are functionally identical, but "sell one" appears above "sell all". You can also use them for other things.

sellOne/sellAll(): optional, Called when the button is pressed. The standard use would be to decrease/reset the amount of the buyable, And possibly return some currency to the player.

canSellOne/canSellAll(): optional, booleans determining whether or not to show the buttons. If "canSellOne/All" is absent but "sellOne/All" is present, the appropriate button will always show.

- + \ No newline at end of file diff --git a/public/gamedevtree/docs/challenges.html b/public/gamedevtree/docs/challenges.html index c7236f79..bc205f32 100644 --- a/public/gamedevtree/docs/challenges.html +++ b/public/gamedevtree/docs/challenges.html @@ -8,10 +8,10 @@ - + - + @@ -318,7 +318,7 @@ } etc }

Each challenge should have an id where the first digit is the row and the second digit is the column. Individual Challenges can have these features:

  • name: Name of the challenge, can be a string or a function. Can use basic HTML.

  • challengeDescription: A description of what makes the challenge a challenge. You will need to implement these elsewhere It can also be a function that returns updating text. Can use basic HTML.

  • rewardDescription: A description of the reward's effect. You will also have to implement the effect where it is applied. It can also be a function that returns updating text. Can use basic HTML.

  • rewardEffect(): optional, A function that calculates and returns the current values of any bonuses from the reward. Can return a value or an object containing multiple values. Can use basic HTML.

  • rewardDisplay(): optional, A function that returns a display of the current effects of the reward with formatting. Default behavior is to just display the a number appropriately formatted.

  • goal: A Decimal for the amount of currency required to beat the challenge. By default, the goal is in basic Points. The goal can also be a function if its value changes.

  • unlocked(): optional, A function returning a bool to determine if the challenge is visible or not. Default is unlocked.

  • onComplete() - optional, this function will be called when the challenge is completed when previously incomplete.

  • countsAs: optional, If a challenge combines the effects of other challenges in this layer, you can use this. An array of challenge ids. The player is effectively in all of those challenges when in the current one.

By default, challenges use basic Points for the goal. You can change that using these features.

  • currencyDisplayName: optional, the name to display for the currency for the goal

  • currencyInternalName: optional, the internal name for that currency

  • currencyLayer: optional, the internal name of the layer that currency is stored in. If it's not in a layer, omit. If it's not stored directly in a layer, instead use the next feature.

  • currencyLocation: optional, if your currency is stored in something inside a layer (e.g. a buyable's amount), you can access it this way. This is a function returning the object in "player" that contains the value (like player[this.layer].buyables)

  • completionLimit: optional, the amount of times you can complete this challenge. Default is 1 completion.

  • style: Optional, Applies CSS to this challenge, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings)

  • layer: Assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar

  • id: Assigned automagically. It's the "key" which the challenge was stored under, for convenient access. The challenge in the example's id is 11.

- + \ No newline at end of file diff --git a/public/gamedevtree/docs/clickables.html b/public/gamedevtree/docs/clickables.html index 3c68d3ca..038d9fec 100644 --- a/public/gamedevtree/docs/clickables.html +++ b/public/gamedevtree/docs/clickables.html @@ -8,10 +8,10 @@ - + - + @@ -322,7 +322,7 @@ } etc }

Features:

  • title: optional, displayed at the top in a larger font It can also be a function that returns updating text.

  • effect(): optional, A function that calculates and returns the current values of bonuses of this clickable. Can return a value or an object containing multiple values.

  • display(): A function returning everything that should be displayed on the clickable after the title, likely changing based on its state. Can use basic HTML.

  • unlocked(): optional, A function returning a bool to determine if the clickable is visible or not. Default is unlocked.

  • canClick(): A function returning a bool to determine if you can click the clickable.

  • onClick(): A function that implements clicking one of the clickable.

  • style: Optional, Applies CSS to this clickable, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings)

  • layer: Assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar.

  • id: Assigned automagically. It's the "key" which the clickable was stored under, for convenient access. The clickable in the example's id is 11.

- + \ No newline at end of file diff --git a/public/gamedevtree/docs/custom-tab-layouts.html b/public/gamedevtree/docs/custom-tab-layouts.html index 634b4798..d63b76db 100644 --- a/public/gamedevtree/docs/custom-tab-layouts.html +++ b/public/gamedevtree/docs/custom-tab-layouts.html @@ -8,10 +8,10 @@ - + - + @@ -318,7 +318,7 @@ "blank", ["toggle", ["c", "beep"]], "milestones", "blank", "blank", "upgrades"]

It is a list of components, which can be either just a name, or an array with arguments. If it's an array, the first item is the name of the component, the second is the data passed into it, and the third (optional) applies a CSS style to it with a "CSS object", where the keys are CSS attributes.

These are the existing components, but you can create more in v.js:

  • display-text: Displays some text (can use basic HTML). The argument is the text to display. It can also be a function that returns updating text.

  • raw-html: Displays some basic HTML, can also be a function.

  • blank: Adds empty space. The default dimensions are 8px x 17px. The argument changes the dimensions. If it's a single value (e.g. "20px"), that determines the height. If you have a pair of arguments, the first is width and the second is height.

  • row: Display a list of components horizontally. The argument is an array of components in the tab layout format.

  • column: Display a list of components vertically. The argument is an array of components in the tab layout format. This is useful to display columns within a row.

  • main-display: The text that displays the main currency for the layer and its effects.

  • resource-display: The text that displays the currency that this layer is based on, as well as the best and/or total values for this layer's prestige currency (if they are put in startData for this layer)

  • prestige-button: The argument is a string that the prestige button should say before the amount of currency you will gain. It can also be a function that returns updating text.

  • upgrades, milestones, challs, achievements: Display the upgrades, milestones, and challenges for a layer, as appropriate.

  • buyables, clickables: Display all of the buyables/clickables for this layer, as appropriate. The argument optional, and is the size of the boxes in pixels.

  • microtabs: Display a set of subtabs for an area. The argument is the name of the set of microtabs in the "microtabs" feature.

  • bar: Display a bar. The argument is the id of the bar to display.

  • infobox: Display an infobox. The argument is the id of the infobox to display.

  • toggle: A toggle button that toggles a bool value. The data is a pair that identifies what bool to toggle, [layer, id]

The rest of the components are sub-components. They can be used just like other components, but are typically part of another component.

  • upgrade, milestone, chall, buyable, clickable, achievement: An individual upgrade, challenge, etc. The argument is the id. This can be used if you want to have upgrades split up across multiple subtabs, for example.

  • respec-button, master-button: The respec and master buttons for buyables and clickables, respectively.

  • sell-one, sell-all: The "sell one" and "sell all" for buyables, respectively. The argument is the id of the buyable.

- + \ No newline at end of file diff --git a/public/gamedevtree/docs/getting-started.html b/public/gamedevtree/docs/getting-started.html index 74df9104..61990249 100644 --- a/public/gamedevtree/docs/getting-started.html +++ b/public/gamedevtree/docs/getting-started.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Getting started ​

Welcome to The Modding Tree!

Using the Modding Tree, at its simplest level, just requires getting a copy of it onto your computer. However, if you do it the right way, it will help in many ways.

Don't let the word "Github" scare you away. It's actually much easier to use than most people think, especially because most people use it the hard way. The key is Github Desktop, which lets you do everything you need to, without even touching the command line.

The benefits of using Github:

  • It makes it much, much easier to update The Modding Tree.
  • You can share your work without any extra effort using githack, or with a bit more effort, set up a github.io site.
  • It lets you undo changes to your code, and to have multiple versions of it.
  • It lets you collaborate with other people, if you want to.

Getting set up with Github and The Modding Tree: ​

  1. Install Github Desktop and Visual Studio Code.

  2. Make a Github account. You can handle this on your own.

  3. Log in on your browser, and go back to The Modding Tree page. At the top right, there should be a button that says "fork". Click on it, and then on your username. You now have your own fork, or copy, of The Modding Tree.

  4. Open Github Desktop and log in. Ignore everything else and choose "clone a repository". A "repository" is basically a "Github project", like The Modding Tree. "Cloning" is downloading a copy of the repository to your computer.

  5. Look for The Modding Tree in the list of repositiories (it should be the only one) and click "clone".

  6. Select that you're using it for your own purposes, and click continue. It will download the files and handle everything.

Using your repository ​

  1. Click on "show in finder" to the right, and then open index.html. This will let you view and test your project!

  2. To edit your project, click "open in VSCode" in Github Desktop.

  3. Open mod.js in VSCode, and look at the top part where it says "modInfo". On the lines below that, change the mod's name to whatever you want, and change the id as well. (It can be any string value, and it's used to determine where the savefile is. Make it something that's probably unique, and don't change it again later.)

  4. Save game.js, and then reload index.html. The title on the tab, as well as on the info page, will now be the new ones!

  5. Go back to Github Desktop. It's time to save your changes into the git system by making a "commit".

  6. At the bottom right corner, add a summary of your changes, and then click "commit to master".

  7. Finally, at the top middle, click "push origin" to push your changes out onto the online repository.

  8. You can view your project on line, or share it with others, by going to https://raw.githack.com/[YOUR-GITHUB-USERNAME]/The-Modding-Tree/master/index.html

And now, you have successfully used Github! You can look at the documentation to see how The Modding Tree's system works and to make your mod a reality.

- + \ No newline at end of file diff --git a/public/gamedevtree/docs/infoboxes.html b/public/gamedevtree/docs/infoboxes.html index 47708345..d4717596 100644 --- a/public/gamedevtree/docs/infoboxes.html +++ b/public/gamedevtree/docs/infoboxes.html @@ -8,10 +8,10 @@ - + - + @@ -316,7 +316,7 @@ } etc }

Features:

  • title: The text displayed above the main box. Can be a function to be dynamic, and can use basic HTML.

  • body: The text displayed inside the box. Can be a function to be dynamic, and can use basic HTML.

  • style, titleStyle, bodyStyle: Optional, Apply CSS to the infobox, or to the title button or body of the infobox, in the form of an object where the keys are CSS attributes, and the values are the Values for those attributes (both as strings).

  • unlocked(): optional, A function returning a bool to determine if the infobox is visible or not. Default is unlocked.

  • layer: Assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar

  • id: Assigned automagically. It's the "key" which the bar was stored under, for convenient access. The bar in the example's id is "bigBar".

- + \ No newline at end of file diff --git a/public/gamedevtree/docs/layer-features.html b/public/gamedevtree/docs/layer-features.html index 99293094..510ecdd3 100644 --- a/public/gamedevtree/docs/layer-features.html +++ b/public/gamedevtree/docs/layer-features.html @@ -8,10 +8,10 @@ - + - + @@ -325,7 +325,7 @@ "challenge"() {return {'height': '200px'}}, "prestige-button"() {return {'color': '#AA66AA'}}, },

Custom Prestige type ​

  • getResetGain(): For custom prestige type, Returns how many points you should get if you reset now. You can call getResetGain(this.layer, useType = "static") or similar to calculate what your gain would be under another prestige type (provided you have all of the required features in the layer.)

  • getNextAt(canMax=false): For custom prestige type, Returns how many of the base currency you need to get to the next point. canMax is an optional variable used with Static-ish layers to differentiate between if it's looking for the first point you can reset at, or the requirement for any gain at all. (Supporting both is good). You can also call getNextAt(this.layer, canMax=false, useType = "static") or similar to calculate what your next at would be under another prestige type (provided you have all of the required features in the layer.)

  • canReset(): For custom prestige type, return true only if you have the resources required to do a prestige here.

- + \ No newline at end of file diff --git a/public/gamedevtree/docs/main-mod-info.html b/public/gamedevtree/docs/main-mod-info.html index 378f1f99..54ba9b8a 100644 --- a/public/gamedevtree/docs/main-mod-info.html +++ b/public/gamedevtree/docs/main-mod-info.html @@ -8,10 +8,10 @@ - + - + @@ -314,7 +314,7 @@ weather: "Yes", happiness: new Decimal(72), }}

  • displayThings: An array of functions used to display extra things at the top of the tree tab. Each function returns a string, which is a line to display (with basic HTML support). If a function returns nothing, nothing is displayed (and it doesn't take up a line).

  • isEndgame(): A function to determine if the player has reached the end of the game, at which point the "you win!" screen appears.

Less important things beyond this point!

  • maxTickLength(): Returns the maximum tick length, in milliseconds. Only really useful if you have something that reduces over time, which long ticks mess up (usually a challenge).
- + \ No newline at end of file diff --git a/public/gamedevtree/docs/milestones.html b/public/gamedevtree/docs/milestones.html index 3e762e69..2fed3730 100644 --- a/public/gamedevtree/docs/milestones.html +++ b/public/gamedevtree/docs/milestones.html @@ -8,10 +8,10 @@ - + - + @@ -316,7 +316,7 @@ etc }

You can use hasMilestone(layer, id) to determine if the player has a given milestone

Milestone features:

  • requirementDesc: A string describing the requirement for unlocking this milestone. Suggestion: Use a "total". It can also be a function that returns updating text. Can use basic HTML.

  • effectDesc: A string describing the reward for having the milestone. You will have to implement the reward elsewhere. It can also be a function that returns updating text. Can use basic HTML.

  • done(): A function returning a boolean to determine if the milestone should be awarded.

  • toggles: optional, Creates toggle buttons that appear on the milestone when it is unlocked. The toggles can toggle a given boolean value in a layer. It is defined as an array of paired items, one pair per toggle. The first is the internal name of the layer the value being toggled is stored in, and the second is the internal name of the variable to toggle. (e.g. [["b", "auto"], ["g", "auto"])

         **Tip:** Toggles are not de-set if the milestone becomes locked! In this case, you should also check if the player has the milestone.

  • style: Optional, Applies CSS to this milestone, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings)

  • unlocked(): Optional A function returning a boolean to determine if the milestone should be shown. If absent, it is always shown.

  • layer: Assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar

  • id: Assigned automagically. It's the "key" which the milestone was stored under, for convenient access. The milestone in the example's id is 0.

- + \ No newline at end of file diff --git a/public/gamedevtree/docs/subtabs-and-microtabs.html b/public/gamedevtree/docs/subtabs-and-microtabs.html index ffa2886d..063210b4 100644 --- a/public/gamedevtree/docs/subtabs-and-microtabs.html +++ b/public/gamedevtree/docs/subtabs-and-microtabs.html @@ -8,10 +8,10 @@ - + - + @@ -332,7 +332,7 @@ // There could be another set of microtabs here } },

Normal subtabs and microtab subtabs both use the same features:

Features: ​

  • content: The tab layout code for the subtab, in the tab layout format

  • style: Optional, Applies CSS to the whole subtab when switched to, in the form of an "CSS Object", where the keys are CSS attributes, and the values are the values for those attributes (both as strings)

  • buttonStyle: Optional, A CSS object, which affects the appearance of the button for that subtab.

  • unlocked(): Optional, a function to determine if the button for this subtab should be visible. By default, a subtab is always unlocked. (You can't use the "this" keyword in this function.)

- + \ No newline at end of file diff --git a/public/gamedevtree/docs/updating-tmt.html b/public/gamedevtree/docs/updating-tmt.html index 65acd392..cef736e2 100644 --- a/public/gamedevtree/docs/updating-tmt.html +++ b/public/gamedevtree/docs/updating-tmt.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Updating The Modding Tree ​

This tutorial assumes that you have used the Getting Started Tutorial, and are using Github Desktop and VSCode for your mod.

Here's what you have to do when there's a TMT update:

  1. Look at the changelog. It will warn you if the update will break anything or require any changes. Decide if you want to try to update.

  2. Open Github Desktop, and at the top middle, click "fetch origin". This will make Github Desktop get information about the update.

  3. Click where it says "current branch: master" at the top middle, and at the bottom of the thing that appears, click "choose a branch to merge into master.

  4. Select upstream/master. It will likely say there are conflicts, but you have tools to resolve them. Click "Merge upstream/master into master".

  5. A conflict happens when the things you're trying to merge have both made changes in the same place. Click "open in Visual Studio Code" next to the first file.

  6. Scroll down through the file, and look for the parts highlighted in red and green. One of these is your code, and the other is some code that will be modified by the update. Do your best to try to edit things to keep the updated changes, but keep your content.

  7. Continue to do this for all remaining challenges.

  8. Do any other changes required by the update, run the game, fix issues, etc.

- + \ No newline at end of file diff --git a/public/gamedevtree/docs/upgrades.html b/public/gamedevtree/docs/upgrades.html index 5242e044..4ee9ea18 100644 --- a/public/gamedevtree/docs/upgrades.html +++ b/public/gamedevtree/docs/upgrades.html @@ -8,10 +8,10 @@ - + - + @@ -318,7 +318,7 @@ } etc }

Each upgrade should have an id where the first digit is the row and the second digit is the column. Individual upgrades can have these features:

  • title: optional, displayed at the top in a larger font It can also be a function that returns updating text. Can use basic HTML.

  • description: A description of the upgrade's effect. You will also have to implement the effect where it is applied. It can also be a function that returns updating text. Can use basic HTML.

  • effect(): optional, A function that calculates and returns the current values of any bonuses from the upgrade. Can return a value or an object containing multiple values.

  • effectDisplay(): optional, A function that returns a display of the current effects of the upgrade with formatting. Default behavior is to just display the a number appropriately formatted. Can use basic HTML.

  • cost: A Decimal for the cost of the upgrade. By default, upgrades cost the main prestige currency for the layer.

  • unlocked(): optional, A function returning a bool to determine if the upgrade is visible or not. Default is unlocked.

  • onPurchase() - optional, this function will be called when the upgrade is purchased. Good for upgrades like "makes this layer act like it was unlocked first".

By default, upgrades use the main prestige currency for the layer. You can include these to change them (but it needs to be a Decimal):

  • currencyDisplayName: optional, the name to display for the currency for the upgrade

  • currencyInternalName: optional, the internal name for that currency

  • currencyLayer: optional, the internal name of the layer that currency is stored in. If it's not in a layer (like Points), omit. If it's not stored directly in a layer, instead use the next feature.

  • currencyLocation: optional, if your currency is stored in something inside a layer (e.g. a buyable's amount), you can access it this way. This is a function returning the object in "player" that contains the value (like player[this.layer].buyables)

  • style: Optional, Applies CSS to this upgrade, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings)

  • layer: Assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar

  • id: Assigned automagically. It's the "key" which the upgrade was stored under, for convenient access. The upgrade in the example's id is 11.

- + \ No newline at end of file diff --git a/public/kronos/Old Things/2.0-format-changes.html b/public/kronos/Old Things/2.0-format-changes.html index 5a370441..a3878d51 100644 --- a/public/kronos/Old Things/2.0-format-changes.html +++ b/public/kronos/Old Things/2.0-format-changes.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

2.0 format changes ​

  • Temp format is changed from temp.something[layer] to temp[layer].something, for consistency
  • Challenges are now saved as an object with the amount of completions in each spot. (This will break saves.)
  • effectDisplay in Challenges and Upgrades no longer takes an argument, and neither does effect for Buyables
  • Buyable cost can take an argument for amount of buyables, but it needs to function if no argument is supplied (it should do the cost for the next purchase).
  • Generation of Points now happens in the main game loop (not in a layer update function), enabled by canGenPoints in game.js.
  • Changed fullLayerReset to layerDataReset, which takes an array of names of values to keep

In addition, many names were changed, mostly expanding abbreviations:

All instances of:

  • chall -> challenge
  • unl -> unlocked
  • upg -> upgrade (besides CSS)
  • amt -> amount
  • desc -> description
  • resCeil -> roundUpCost
  • order -> unlockOrder
  • incr_order -> increaseUnlockOrder

Challenges:

  • desc -> challengeDescription
  • reward -> rewardDescription
  • effect -> rewardEffect
  • effectDisplay -> rewardDisplay
  • active -> challengeActive
- + \ No newline at end of file diff --git a/public/kronos/README.html b/public/kronos/README.html index ac491acd..0ba458d8 100644 --- a/public/kronos/README.html +++ b/public/kronos/README.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Kronos ​

Play here.

Updating the website:

  • git submodule update --remote
  • git add -A
  • git commit -m "Updated kronos"
  • git push
- + \ No newline at end of file diff --git a/public/kronos/changelog.html b/public/kronos/changelog.html index cb342114..99d6cdea 100644 --- a/public/kronos/changelog.html +++ b/public/kronos/changelog.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

The Modding Tree changelog: ​

v2.5.9.2 - 5/19/21 ​

  • Fixed many issues with things not updating.

v2.5.9.1 - 5/18/21 ​

  • Made text inputs never give NaNs.

v2.5.9 - 5/18/21 ​

  • Fixed issue when using text inputs for Numbers.
  • Added particle color feature.
  • Particle speed and dir are updated as it moves.
  • Added setSpeed and setDir for particles.
  • Added more trig functions.

v2.5.8 - 5/17/21 ​

  • Added makeShinies, which creates a stationary particle in a random spot.
  • Bars will visually update more quickly.
  • Fixed a major particle-related issue.
  • Fixed autoUpgrade.
  • Fixed a minor visual issue with tree nodes.

v2.5.7 - 5/15/21 ​

  • Added a particle system! Not only can it be used for visual effects, but particles can interact with the mouse. They could be used to create golden cookies or collectables, for example.
  • Added marked feature to buyables, clickables, and challenges. By default, stars multi-completion challenges when maxed.
  • Added 'deactivated' feature to layers, which disables many features.
  • Improved number formatting slightly.

v2.5.6 - 5/14/21 ​

  • You can now use non-numeric ids for upgrades, buyables, etc.
  • Fixed an exploit that let you buy an extra buyable.
  • Moved basic getter/setter functions to easyAccess.js.

v2.5.5.2 - 5/12/21 ​

  • Fixed a major issue with buyables.
  • Fixed a variety of tabFormat-related issues.
  • Fixed commas appearing in decimal places (thanks to pg132!)

v2.5.5.1 - 5/12/21 ​

  • Fixed clickables.

v2.5.5 - 5/12/21 ​

  • Added grids! They are a grid of buttons which behave the same, but have their own data. Good for inventory grids, map tiles, and more!
  • Added "marked" feature to add a mark to a node. Can be an image instead of a star. (Originally by Jacorb)
  • Added "layer-proxy" component that lets you use components from another layer.
  • Added the ability to display non-whole numbers in main-display.

v2.5.4 - 5/10/21 ​

  • Added a setting to always use single-tab mode.
  • Added directMult, which multiplies prestige gain after exponents and softcaps. It actually multiplies gain for static layers.
  • Added onEnter and onExit for challenges.
  • Improved displaying numbers between 0.0001 and 0.1.
  • Added documentation on how gainMult/Exp work for static layers.
  • Fixed a visual issue on mobile, thanks to thepaperpilot.
  • Improved documentation in general.

v2.5.3 - 5/8/21 ​

  • Improved performance of tab formats and bars.
  • Respec confirmation settings are now kept on resets.
  • Improved compatibility with older browsers.
  • Fixed missing pixel on vertical bars.

v2.5.2.1 - 5/7/21 ​

  • Fixed microtabs making layers highlight incorrectly.

v2.5.2 - 5/7/21 ​

  • Added glowColor for subtabs.
  • Improved the display for extremely small numbers.
  • Fixed issues in the buyable docs.

v2.5.1 - 5/7/21 ​

  • Fixed dynamic things in tabFormat not updating.

v2.5: Dreams Really Do Come True - 5/7/21 ​

  • Optimizations, hopefully a significant amount.
  • Added OOM/s point gen display at high values (thanks to Ducdat!)
  • Only one tab will display if the window is not wide enough (also thanks to Ducdat!)
  • Holding down a buyable's button now buys it continuously.
  • New milestone setting will also show the most recently unlocked milestone. (Also renamed all settings to be clearer)
  • Added an onHold feature for clickables.
  • Layer nodes will be highlighted even if the player is on the same tab.
  • Added customizable node glowColor.
  • Added buyable purchaseLimit.
  • Amount is automatically supplied to buyable cost and effect functions.
  • Locked (not yet visible) milestones no longer take up space. Also fixed hidden milestones taking a tiny bit of space.
  • Re-centered respec buttons.
  • Force-displayed tooltips are not hidden by resets.
  • Added formatting support for very small numbers. Disabled in most places by default because rounding errors might cause issues. Access it with formatSmall, or enable it globally by adding "allowSmall: true" to modInfo.

v2.4.1 - 4/29/21 ​

  • A number of minor fixes, many thanks to thepaperpilot.
  • The respec confirmation checkbox is now part of the respec-button component. (This also fixes the checkbox appearing when there is no respec button)
  • Added a few undocumented changes to the 2.4 changelog (the two at the bottom)

v2.4: Rationalized Edition - 4/29/21 ​

  • Completely reworked tooltips. Shift-click a node to force its tooltip to stay displayed. (And hopefully finally fixed flickering!)

  • Added text-input and slider components.

  • Added the ability to toggle respec confirmations.

  • Added custom respec confirmation messages.

  • The red layer highlight will not appear before a layer is unlocked.

  • Added unlocking hotkeys.

  • You no longer need to supply 'rows' and 'cols' for any Big Features.

  • Node symbols can use HTML.

  • Added documentation for the respec button.

  • Added prestigeNotify to subtabs, and prestigeNotify in subtabs also highlights the layer node.

  • The version number no longer contains special characters or irrational numbers.

  • Added ctrlDown and shiftDown variables.

  • Tooltips now use HTML (this means you need to replace any newlines with
    )

v2.π.1 - 4/7/21 ​

  • Fixed formatting for some larger numbers.
  • Upgrades will expand if there is too much text to display.
  • Fixed styling challenges.
  • No longer attempts to display a base currency when there is none.

v2.π: Incrementally Updated - 2/5/21 ​

  • Performance improvements.
  • Fixed tooltips overlapping with the top display.
  • Clicking a popup dismisses it immediately.
  • Added support for bulk challenge completions.
  • "Best" is updated automatically.
  • Fixed keeping Decimal values on reset.
  • Code reorganization and style improvements by fudo.

v2.3.5 - 12/21/20 ​

  • Added resetTime, which tracks the time since a layer prestiged or was reset.
  • A layer node will be highlighted red if one of its subtabs is highlighted red.
  • Fixed issues with keeping challenges, buyables, and clickables on reset.
  • Improved the unlocking of custom layers.
  • Other minor fixes.

v2.3.4 - 12/16/20 ​

  • Added a node image feature.
  • Resource display now always shows the amount of the currency the layer's gain is based on.
  • Added spacing between tree nodes.
  • Another attempt to fix tooltip flickering.

v2.3.3 - 12/13/20 ​

  • Fixed the first node in a row always taking up space.
  • layerShown is now optional.
  • All prestige types can now use features for custom prestige types.

v2.3.2 - 12/13/20 ​

  • Fixed achievement/milestone popups.

v2.3.1 - 12/12/20 ​

  • Another attempt to fix flickering tooltips.
  • The "this" keyword should work everywhere except tabFormat arrays (although I may have missed some things).
  • Fixed tree branches not updating when scrolling on the right-side tab.
  • Fixed a spacing issue when a node's symbol is ""
  • Removed some old, unneeded files.

v2.3: Cooler and Newer Edition - 12/10/20 ​

  • Added achievement/milestone popups (thank you to Jacorb for this contribution!)
  • The changelog tab is back, and can be set in mod.js.
  • Layer nodes and respec buttons will not be clicked by pressing "enter".
  • Possible fix for flickering tooltips and strange transitions.
  • The victory screen text is configurable.
  • Added image and textStyle features to achievements.
  • Added an argument to use specific rows in an "upgrades" component.
  • Fixed the comma appearing in the main display when there was no effectDescription
  • Added the ability to easily make a tab that is a collection of layers in subtabs.
  • Improved spacing for embedding layers with subtabs into subtabs.

v2.2.8 - 12/03/20 ​

  • Double-clicking a layer node brings you to the main subtab for that layer.
  • Attempted to fix challenges visually updating a different way.
  • Added a softcap function for use in formulas.
  • Added displayRow feature, which lets layers be shown somewhere separate from where they are in the reset order (e.g. side layers)
  • Fixed autoupgrade issue.

v2.2.7 - 11/30/20 ​

  • Added autoUpgrade feature.
  • resource-display now shows resource gain per second if passiveGain is active.
  • Fixed formatting issues on some large numbers.
  • Better support for using classed objects in player and in layers/tmp.
  • Made hard resetting more effective.
  • Removed Herobrine from getStartClickables.

v2.2.6 - 11/30/20 ​

  • Added goalDescription for challenges and made the new "canComplete" system the standard.
  • Another attempt to fix challenges not visually updating.
  • Fixed side layers not appearing.
  • Fixed getStartClickables again.

v2.2.5 - 11/29/20 ​

  • Added features for overriding the displays and costs/goals of upgrades and challenges to make them fully custom.
  • best, total, and unlocked are always automatically added to layerData (but best and total will only display if you add them yourself).
  • Fixed getStartClickables.

v2.2.4 - 11/28/20 ​

  • Added softcap and softcapPower features (for Normal layers)
  • Offline time limit and default max tick length were fixed (previously the limits were 1000x too large)
  • Added fixOldSaves.
  • You can use HTML in main-display.
  • Fixed a number of minor oddities.

v2.2.3 - 11/28/20 ​

  • Layers will be highlighted if you can finish a challenge.
  • The "can complete challenge" color now overrides the "already completed" color.
  • Button nodes now work as side "layers".
  • Setting a tooltip to "" hides it entirely.

v2.2.2 - 11/22/20 ​

  • Fixed right half of the screen being unclickable in some circumstances.
  • Fixed tree branches being offset.
  • Fix to lastSafeTab.

v2.2.1 - 11/7/20 ​

  • Added a small highlight to layers you can meaningfully prestige on.
  • Added passiveGeneration and autoPrestige features to standardize prestige automation. (The old ways still work, but the new ones work better with other things)
  • Improved milestones visually a bit.
  • "best" and "total" are now only displayed if present in startData.
  • Fixed issues with things not updating visually. (Thank you to to Jacorb!)
  • Side layers and button nodes can now be highlighted.
  • Updated docs on the new tree-related features.

v2.2: Uprooted - 11/7/20 ​

  • You can now embed a layer inside of a subtab or microtab!
  • Added support for hiding or reformatting the tree tab
  • Added non-layer button nodes
  • Added shouldNotify to subtab/microtab buttons. (You can make them highlighted)
  • Added commas to large exponents.
  • Upgrades now only show "currently" if they have an effectDisplay (so not for constant effects).
  • Achievements are part of the default tab format.
  • NaN is now handled more intelligently.
  • Renamed files, and moved less relevant ones to another folder.
  • The "hide completed challenges" setting now only hides challenges at max completions.
  • Thank you to thepaperpilot for fixing errors in docs and improving the infobox appearance!
  • Many other minor fixes.

v2.1.4 - 10/25/20 ​

  • Added an infobox component. Thank you to thepaperpilot for this contribution!
  • Layer type is now optional, and defaults to "none".
  • Improved the look of bars and tab buttons.
  • Improved spacing between layer nodes (also thanks to thepaperpilot!)
  • Fixed the "blank" component breaking if only specifying the height.
  • Fixed some numbers not displaying with enough digits.
  • Made a few more things able to be functions.
  • A few other minor fixes.

v2.1.3.1 - 10/21/20 ​

  • Fixed the update function.

v2.1.3 - 10/21/20 ​

  • gainMult and gainExp are now optional.
  • Layer unlocking is now kept on reset.
  • Game should start up faster.
  • Layer updates now have a determined order and starts with earlier-rowed layers.
  • Automation now has a determined order and starts with later-rowed layers.
  • Fixed issues with resetting clickables and challenges.
  • Commas should no longer appear in the decimal places of a number.
  • Fixed potential issue in displaying the tree.

v2.1.2 - 10/19/20 ​

  • Added buyUpgrade function (buyUpg still works though)
  • Added author name to modInfo.
  • Fix to crash caused when the name of a subtab or microtab is changed.
  • Fixes to outdated information in docs.
  • Improvements to Discord links.
  • Thank you to thepaperpilot for contributing to this update!

v2.1.1 - 10/17/20 ​

  • Added resource-display component, which displays the base currency for the prestige layer, as well as the best and/or total of this layer's prestige currency.
  • Fixed the value for the base currency not updating in resource-display.

v2.1: We should have thought of this sooner! - 10/17/20 ​

  • Moved most of the code users will want to edit to mod.js, added documentation for it.
    • Specifically, modInfo, VERSION, canGenPoints, getPointGen, and maxTickLength
  • Added getStartPoints()
  • Added the ability to store non-layer-related data
  • Added the ability to display more things at the top of the tree tab below points.
  • Made the endgame condition customizable
  • Added "sell one" and "sell all" buttons for buyables.
  • Moved the old "game" to demo.js, and replaced it with a minimal game that won't cause issues when edited.
  • Fixed issues with version number
  • Fixed number formatting issue making things like "10e9" appear.

v2.0.5 - 10/16/20 ​

  • Made more features (including prestige parameters) able to be dynamic.
  • Layer nodes can be hidden but still take up space with "ghost" visibility
  • Added clickableEffect for real.
  • Fixed some visual issues with bars.
  • A few other minor tweaks and improvements.

v2.0.4 - 10/16/20 ​

  • Fixed HTML on buttons interfering with clicking on them.

v2.0.3 - 10/16/20 ​

  • Fixed hotkeys not displaying in info.
  • Fixed the game supressing all external hotkeys.
  • You can use more things as currencies for upgrade costs and challenge goals using currencyLocation.
  • Added maxTickLength, which can be used to prevent offline time or tab-switching from breaking time-limit based mechanics.
  • Made buyable respec buttons and clickable "master" buttons their own components, and gave them a hide/show feature.
  • Added a general "tooltip" feature for achievements.

v2.0.2 - 10/15/20 ​

  • Branches are now dynamic (they can be functions).
  • Fixed a crash related to offline time.
  • Fixed links being too wide.

v2.0.1 - 10/15/20 ​

  • Fixed side layers appearing multiple times.

v2.0: The Pinnacle of Achievement Mountain - 10/15/20 ​

  • Added progress bars, which are highly customizable and can be horizontal or vertical!
  • Added "side layers", displayed smaller and off to the side, and don't get reset by default. They can be used for global achievements and statistics. Speaking of which...
  • Added achievements!
  • Added clickables, a more generalized variant of buyables.
  • Almost every value in layer data can be either a function or a constant value!
  • Added support for multiple completions of challenges.
  • Added "none" prestige type, which removes the need for any other prestige-related features.
  • The points display and other gui elements stay at the top of the screen when the tree scrolls.
  • Added getter/setter functions for the amounts and effects of most Big Features
  • Moved modInfo to game.js, added a spot in modInfo for a Discord link, changelog link. Also added a separate mod version from the TMT version in VERSION.
  • Tree structure is based on layer data, no index.html editing is needed.
  • Tmp does not need to be manually updated.
  • You don't have to have the same amount of upgrades in every row (and challs and buyables)
  • "unlocked" is optional for all Big Components (defaults to true).
  • All displays will update correctly.
  • Changelog is no longer in index.html at all.
  • Generation of Points now happens in the main game loop
  • Changed the reset functions to make keeping things easier
  • Renamed many things to increase readability (see the list in the link below)
  • Improved documentation based on feedback

v1.3.5: ​

  • Completely automated convertToDecimal, now you never have to worry about it again.
  • Branches can be defined without a color id. But they can also use hex values for color ids!
  • Created a tutorial for getting started with TMT and Github.
  • Page title is now automatically taken from mod name.

v1.3.4 - 10/8/20 ​

  • Added "midsection" feature to add things to a tab's layout while still keeping the standard layout.
  • Fix for being able to buy more buyables than you should.

v1.3.3 - 10/7/20 ​

  • Fix for the "order of operations" issue in temp.

v1.3.1 - 10/7/20 ​

  • Added custom CSS and tooltips for Layer Nodes.
  • Added custom CSS for upgrades, buyables, milestones, and challenges, both individually and layer-wide.
  • You can now use HTML in most display text!
  • You can now make milestones unlockable and not display immediately.
  • Fixed importing saves, and issue with upgrades not appearing, and probably more.
  • Optional "name" layer feature, used in confirmation messages.

v1.3: Tabception... ception! - 10/7/20 ​

  • Added subtabs! And also a Micro-tab component to let you make smaller subtab-esque areas anywhere.
  • Added a "custom" prestige formula type, and a number of features to support it.
  • Added points/sec display (can be disabled).
  • Added h-line, v-line and image-display components, plus components for individual upgrades, challenges, and milestones.
  • Added upgEffect, buyableEffect, and challEffect functions.
  • Added "hide completed challenges" setting.
  • Moved old changelogs to a separate place.
  • Fixed hasMilestone and incr_order.
  • Static layers now show the currency amount needed for the next one if you can buy max.

v1.2.4 - 10/4/20 ​

  • Layers are now highlighted if you can buy an upgrade, and a new feature, shouldNotify, lets you make it highlight other ways.
  • Fixed bugs with hasUpg, hasChall, hasMilestone, and inChallenge.
  • Changed the sample code to use the above functions for convenience.

v1.2.3 - 10/3/20 ​

  • Added a row component, which displays a list of objects in a row.
  • Added a column component, which displays a list of objects in a column (useful within a row).
  • Changed blanks to have a customizable width and height.

v1.2: This Changes Everything! - 10/3/20 ​

  • Many layer features can now be static values or functions. (This made some formats change, which will break old things)
  • You can now use the "this" keyword, to make code easier to transfer when making new layers.
  • Also added "this.layer", which is the current layer's name, and works on existing subfeatures (e.g. individual upgrades) as well! Subfeatures also have "this.id".
  • Fixed a big save issue. If you use a unique mod id, your save will never conflict with other mods.
  • Added a configurable offline time limit in modinfo at the top of index.html. (default 1 hour)
  • Added a few minor features, and updated the docs with new information.

v1.1.1 - 9/30/20 ​

  • You can define hotkeys directly from layer config.

v1.1: Enhanced Edition - 9/30/20 ​

  • Added "Buyables", which can function like Space Buildings or Enhancers.
  • Custom CSS can now be used on any component! Make the third argument an object with CSS parameters.
  • Lots of minor good things.

v1.0 - 9/27/20 ​

  • First release.
- + \ No newline at end of file diff --git a/public/kronos/docs/!general-info.html b/public/kronos/docs/!general-info.html index 626813f4..b7f40cdb 100644 --- a/public/kronos/docs/!general-info.html +++ b/public/kronos/docs/!general-info.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

The-Modding-Tree ​

Making a game in The Modding Tree mostly involves defining parameters or functions on objects. If you aren't following the getting started guide, you should start by setting up your basic mod info in mod.js. It's important to set a mod id to ensure saving works properly.

Beyond that, the main way to add content is through creating layers, often in layers.js. You can add new layers by calling addLayer(layername, layerdata). There is an example of a basic layer in layers.js showing the recommended method. It is just an example and can be freely deleted. You can also use it as a reference or a base for your own layers.

Most of the time, you won't need to dive deep into the code to create things, but you still can if you really want to, for example to add new Vue components in components.js.

The Modding Tree uses break_eternity.js to store large values. This means that many numbers are Decimal objects, and must be treated differently. For example, you have to use new Decimal(x) to create a Decimal value instead of a plain number, and perform operations on them by calling functions. e.g, instead of x = x + y, use x = x.add(y). Keep in mind this also applies to comparison operators, which should be replaced with calling the .gt, .gte, .lt, .lte, .eq, and .neq functions. See the break_eternity.js docs for more details on working with Decimal values.

Almost all values can be either a constant value, or a dynamic value. Dynamic values are defined by putting a function that returns what the value should be at any given time.

All display text can use basic HTML elements (But you can't use most Vue features there).

While reading this documentation, the following key will be used when describing features:

  • No label: This is required and the game may crash if it isn't included.
  • sometimes required: This is may be required, depending on other things in the layer.
  • optional: You can leave this out if you don't intend to use that feature for the layer.
  • assigned automagically: This value will be set automatically and override any value you set.
  • deprecated: This feature is not recommended to be used, because newer features are able to achieve the same thing in a better, easier way.

Table of Contents ​

General ​

  • Getting Started: Getting your own copy of the code set up with Github Desktop.
  • Main mod info: How to set up general things for your mod in mod.js.
  • Basic layer breakdown: Breaking down the components of a layer with minimal features.
  • Layer features: Explanations of all of the different properties that you can give a layer.
  • Custom Tab Layouts: An optional way to give your tabs a different layout. You can even create entirely new components to use.
  • Custom game layouts: You can get rid of the tree tab, add buttons and other things to the tree, or even customize the tab's layout like a layer tab.
  • Updating TMT: Using Github Desktop to update your mod's version of TMT.

Common components ​

  • Upgrades: How to create upgrades for a layer.
  • Milestones: How to create milestones for a layer.
  • Buyables: Create rebuyable upgrades for your layer (with the option to make them respec-able). Can be used to make Enhancers or Space Buildings, for example.
  • Clickables: A more generalized variant of buyables, for any kind of thing that is sometimes clickable. Between these and Buyables, you can do just about anything.
  • Achievements: How to create achievements for a layer (or for the whole game).

Other components and features ​

  • Challenges: How to create challenges for a layer.
  • Bars: Display some information as a progress bar, gauge, or similar. They are highly customizable, and can be horizontal and vertical as well.
  • Subtabs and Microtabs: Create subtabs for your tabs, as well as "microtab" components that you can put inside the tabs. You can even use them to embed a layer inside another layer!
  • [Grids][grids.md]: Create a group buttons that behave the same, but have their own data. Good for map tiles, an inventory grid, and more!
  • Infoboxes: Boxes containing text that can be shown or hidden.
  • Trees: Make your own trees. You can make non-layer button nodes too!
  • Particle system: Can be used to create particles for visual effects, but also interactable things like golden cookies or collectables.
- + \ No newline at end of file diff --git a/public/kronos/docs/achievements.html b/public/kronos/docs/achievements.html index e81e3acc..a18f00b4 100644 --- a/public/kronos/docs/achievements.html +++ b/public/kronos/docs/achievements.html @@ -8,10 +8,10 @@ - + - + @@ -316,7 +316,7 @@ }, etc }

Usually, each achievement should have an id where the first digit is the row and the second digit is the column.

Individual achievement can have these features:

  • name: optional. displayed at the top of the achievement. The only visible text. It can also be a function that returns updating text. Can use basic HTML.

  • done(): A function returning a boolean to determine if the achievement should be awarded.

  • tooltip: Default tooltip for the achievement, appears when it is hovered over. Should convey the goal and any reward for completing the achievement. It can also be a function that returns updating text. Can use basic HTML. Setting this to "" disables the tooltip.

  • effect(): optional. A function that calculates and returns the current values of any bonuses from the achievement. Can return a value or an object containing multiple values.

  • unlocked(): optional. A function returning a bool to determine if the achievement is visible or not. Default is unlocked.

  • onComplete() - optional. this function will be called when the achievement is completed.

  • image: optional, puts the image from the given URL (relative or absolute) in the achievement

  • style: optional. Applies CSS to this achievement, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • textStyle: optional. Applies CSS to the text, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar.

  • id: assigned automagically. It's the "key" which the achievement was stored under, for convenient access. The achievement in the example's id is 11.

  • goalTooltip: optional, deprecated. Appears when the achievement is hovered over and locked, overrides the basic tooltip. This is to display the goal (or a hint). It can also be a function that returns updating text. Can use basic HTML.

  • doneTooltip: optional, deprecated. Appears when the achievement is hovered over and completed, overrides the basic tooltip. This can display what the player achieved (the goal), and the rewards, if any. It can also be a function that returns updating text. Can use basic HTML.

Disable achievement popups by adding achievementsPopups: false to the layer.

- + \ No newline at end of file diff --git a/public/kronos/docs/bars.html b/public/kronos/docs/bars.html index f9e5eb04..27e2e1ee 100644 --- a/public/kronos/docs/bars.html +++ b/public/kronos/docs/bars.html @@ -8,10 +8,10 @@ - + - + @@ -319,7 +319,7 @@ }, etc }

Features:

  • direction: UP, DOWN, LEFT, or RIGHT (not strings). Determines the direction that the bar is filled as it progresses. RIGHT means from left to right.

  • width, height: The size in pixels of the bar, but as numbers (no "px" at the end).

  • progress(): A function that returns the portion of the bar that is filled, from "empty" at 0 to "full" at 1, updating automatically. (Nothing bad happens if the value goes out of these bounds, and it can be a number or Decimal)

  • display(): optional. A function that returns text to be displayed on top of the bar, can use HTML.

  • unlocked(): optional. A function returning a bool to determine if the bar is visible or not. Default is unlocked.

  • baseStyle, fillStyle, borderStyle, textStyle: Optional, Apply CSS to the unfilled portion, filled portion, border, and display text on the bar, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar.

  • id: assigned automagically. It's the "key" which the bar was stored under, for convenient access. The bar in the example's id is "bigBar".

- + \ No newline at end of file diff --git a/public/kronos/docs/basic-layer-breakdown.html b/public/kronos/docs/basic-layer-breakdown.html index 24349acc..f2d520e0 100644 --- a/public/kronos/docs/basic-layer-breakdown.html +++ b/public/kronos/docs/basic-layer-breakdown.html @@ -8,10 +8,10 @@ - + - + @@ -341,7 +341,7 @@ // Look in the upgrades docs to see what goes here! }, }) - + \ No newline at end of file diff --git a/public/kronos/docs/buyables.html b/public/kronos/docs/buyables.html index 2a8ccca6..8cb859eb 100644 --- a/public/kronos/docs/buyables.html +++ b/public/kronos/docs/buyables.html @@ -8,10 +8,10 @@ - + - + @@ -322,7 +322,7 @@ }, etc }

Features:

  • title: optional. displayed at the top in a larger font. It can also be a function that returns updating text.

  • cost(): cost for buying the next buyable. Can have an optional argument "x" to calculate the cost of the x+1th purchase. (x is a Decimal). Can return an object if there are multiple currencies.

  • effect(): optional. A function that calculates and returns the current values of bonuses of this buyable. Can have an optional argument "x" to calculate the effect of having x of the buyable.. Can return a value or an object containing multiple values.

  • display(): A function returning everything that should be displayed on the buyable after the title, likely including the description, amount bought, cost, and current effect. Can use basic HTML.

  • unlocked(): optional. A function returning a bool to determine if the buyable is visible or not. Default is unlocked.

  • canAfford(): A function returning a bool to determine if you can buy one of the buyables.

  • buy(): A function that implements buying one of the buyable, including spending the currency.

  • buyMax(): optional. A function that implements buying as many of the buyable as possible.

  • style: optional. Applies CSS to this buyable, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • purchaseLimit: optional. The limit on how many of the buyable can be bought. The default is no limit.

  • marked: optional Adds a mark to the corner of the buyable. If it's "true" it will be a star, but it can also be an image URL.

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar.

  • id: assigned automagically. It's the "key" which the buyable was stored under, for convenient access. The buyable in the example's id is 11.

Sell One/Sell All:

Including a sellOne or sellAll function will cause an additional button to appear beneath the buyable. They are functionally identical, but "sell one" appears above "sell all". You can also use them for other things.

  • sellOne/sellAll(): optional. Called when the button is pressed. The standard use would be to decrease/reset the amount of the buyable, and possibly return some currency to the player.

  • canSellOne/canSellAll(): optional. booleans determining whether or not to show the buttons. If "canSellOne/All" is absent but "sellOne/All" is present, the appropriate button will always show.

To add a respec button, or something similar, add the respecBuyables function to the main buyables object (not individual buyables). You can use these features along with it:

  • respec(): optional. This is called when the button is pressed (after a toggleable confirmation message).

  • respecText: optional. Text to display on the respec Button.

  • showRespec(): optional. A function determining whether or not to show the button, if respecBuyables is defined. Defaults to true if absent.

  • respecMessage: optional. A custom confirmation message on respec, in place of the default one.

- + \ No newline at end of file diff --git a/public/kronos/docs/challenges.html b/public/kronos/docs/challenges.html index 354ae329..0c4717e3 100644 --- a/public/kronos/docs/challenges.html +++ b/public/kronos/docs/challenges.html @@ -8,10 +8,10 @@ - + - + @@ -318,7 +318,7 @@ }, etc }

Usually, each challenge should have an id where the first digit is the row and the second digit is the column.

Individual Challenges can have these features:

  • name: Name of the challenge, can be a string or a function. Can use basic HTML.

  • challengeDescription: A description of what makes the challenge a challenge. You will need to implement these elsewhere. It can also be a function that returns updating text. Can use basic HTML.

  • goalDescription: A description of the win condition for the challenge. It can also be a function that returns updating text. Can use basic HTML. (Optional if using the old goal system)

  • canComplete(): A function that returns true if you meet the win condition for the challenge. Returning a number will allow bulk completing the challenge. (Optional if using the old goal system)

  • rewardDescription: A description of the reward's effect. You will also have to implement the effect where it is applied. It can also be a function that returns updating text. Can use basic HTML.

  • rewardEffect(): optional. A function that calculates and returns the current values of any bonuses from the reward. Can return a value or an object containing multiple values. Can use basic HTML.

  • rewardDisplay(): optional. A function that returns a display of the current effects of the reward with formatting. Default behavior is to just display the a number appropriately formatted.

  • fullDisplay(): OVERRIDE. Overrides the other displays and descriptions, and lets you set the full text for the challenge. Can use basic HTML.

  • unlocked(): optional. A function returning a bool to determine if the challenge is visible or not. Default is unlocked.

  • onComplete() - optional. this function will be called when the challenge is completed when previously incomplete.

  • onEnter() - optional. this function will be called when entering the challenge

  • onExit() - optional. this function will be called when exiting the challenge in any way

  • countsAs: optional. If a challenge combines the effects of other challenges in this layer, you can use this. An array of challenge ids. The player is effectively in all of those challenges when in the current one.

  • completionLimit: optional. the amount of times you can complete this challenge. Default is 1 completion.

  • style: optional. Applies CSS to this challenge, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • marked: optional Adds a mark to the corner of the challenge. If it's "true" it will be a star, but it can also be an image URL. By default, if the challenge has multiple completions, it will be starred at max completions.

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar

  • id: assigned automagically. It's the "key" which the challenge was stored under, for convenient access. The challenge in the example's id is 11.

The old goal system uses these features:

  • goal: deprecated, A Decimal for the amount of currency required to beat the challenge. By default, the goal is in basic Points. The goal can also be a function if its value changes.

  • currencyDisplayName: deprecated. the name to display for the currency for the goal

  • currencyInternalName: deprecated. the internal name for that currency

  • currencyLayer: deprecated. the internal name of the layer that currency is stored in. If it's not in a layer, omit. If it's not stored directly in a layer, instead use the next feature.

  • currencyLocation(): deprecated. if your currency is stored in something inside a layer (e.g. a buyable's amount), you can access it this way. This is a function returning the object in "player" that contains the value (like player[this.layer].buyables)

- + \ No newline at end of file diff --git a/public/kronos/docs/clickables.html b/public/kronos/docs/clickables.html index 59f39072..2b4391a8 100644 --- a/public/kronos/docs/clickables.html +++ b/public/kronos/docs/clickables.html @@ -8,10 +8,10 @@ - + - + @@ -316,7 +316,7 @@ } etc }

Features:

  • title: optional. displayed at the top in a larger font. It can also be a function that returns updating text.

  • effect(): optional. A function that calculates and returns the current values of bonuses of this clickable. Can return a value or an object containing multiple values.

  • display(): A function returning everything that should be displayed on the clickable after the title, likely changing based on its state. Can use basic HTML.

  • unlocked(): optional. A function returning a bool to determine if the clickable is visible or not. Default is unlocked.

  • canClick(): A function returning a bool to determine if you can click the clickable.

  • onClick(): A function that implements clicking the clickable.

  • onHold(): optional A function that is called 20x/sec when the button is held for at least 0.25 seconds.

  • style: optional. Applies CSS to this clickable, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • marked: optional Adds a mark to the corner of the clickable. If it's "true" it will be a star, but it can also be an image URL.

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar.

  • id: assigned automagically. It's the "key" which the clickable was stored under, for convenient access. The clickable in the example's id is 11.

You can also use these features on the clickables object to add a button above all the clickables, for implementing a respec button or similar.

  • masterButtonPress(): optional. If present, an additional button will appear above the clickables. Pressing it will call this function.

  • masterButtonText: optional. Text to display on the Master Button.

  • showMasterButton(): optional. A function determining whether or not to show the button, if masterButtonPress is defined. Defaults to true if absent.

- + \ No newline at end of file diff --git a/public/kronos/docs/custom-tab-layouts.html b/public/kronos/docs/custom-tab-layouts.html index eeaa1824..cb482f2b 100644 --- a/public/kronos/docs/custom-tab-layouts.html +++ b/public/kronos/docs/custom-tab-layouts.html @@ -8,10 +8,10 @@ - + - + @@ -323,7 +323,7 @@ "blank", "upgrades" ]

It is a list of components, which can be either just a name, or an array with arguments. If it's an array, the first item is the name of the component, the second is the data passed into it, and the third (optional) applies a CSS style to it with a "CSS object", where the keys are CSS attributes.

These are the existing components, but you can create more in components.js:

  • display-text: Displays some text (can use basic HTML). The argument is the text to display. It can also be a function that returns updating text.

  • raw-html: Displays some basic HTML, can also be a function.

  • blank: Adds empty space. The default dimensions are 8px x 17px. The argument changes the dimensions. If it's a single value (e.g. "20px"), that determines the height. If you have a pair of arguments, the first is width and the second is height.

  • row: Display a list of components horizontally. The argument is an array of components in the tab layout format.

  • column: Display a list of components vertically. The argument is an array of components in the tab layout format. This is useful to display columns within a row.

  • main-display: The text that displays the main currency for the layer and its effects. The argument is the amount of precision to use, allowing it to display non-whole numbers.

  • resource-display: The text that displays the currency that this layer is based on, as well as the best and/or total values for this layer's prestige currency (if they are put in startData for this layer).

  • prestige-button: The argument is a string that the prestige button should say before the amount of currency you will gain. It can also be a function that returns updating text.

  • text-input: A text input box. The argument is the name of the variable in player[layer] that the input is for, player[layer][argument] (Works with strings, numbers, and Decimals!)

  • slider: Lets the user input a value with a slider. The argument a 3-element array: [name, min, max]. The name is the name of the variable in player[layer] that the input that the input is for, and min and max are the limits of the slider. (Does not work for Decimal values)

  • upgrades: The layer's upgrades. The argument is optional, and is a the list of rows this component should include, if it doesn't have all of them.

  • milestones, challenges, achievements: Display the upgrades, milestones, and challenges for a layer, as appropriate.

  • buyables, clickables: Display all of the buyables/clickables for this layer, as appropriate. The argument is optional and is the size of the boxes in pixels.

  • microtabs: Display a set of subtabs for an area. The argument is the name of the set of microtabs in the "microtabs" feature.

  • bar: Display a bar. The argument is the id of the bar to display.

  • infobox: Display an infobox. The argument is the id of the infobox to display.

  • tree: Displays a tree. The argument is an array of arrays containing the names of the nodes in the tree (first by row, then by column) See here for more information on tree layouts and nodes!

  • toggle: A toggle button that toggles a bool value. The argument is a pair that identifies the location in player of the bool to toggle, e.g. [layer, id]. 'layer' also affects the color of the toggle.

  • grid: Displays the gridable grid for the layer. If you need more than one grid, use a layer proxy.

  • layer-proxy: Lets you use components from another layer. The argument is a pair, [layer, data], consisting of the id of the layer to proxy from, and the tabFormat for the components to show. (Note: you cannot use a microtab within a layer proxy)

The rest of the components are sub-components. They can be used just like other components, but are typically part of another component.

  • upgrade, milestone, challenge, buyable, clickable, achievement, gridable: An individual upgrade, challenge, etc. The argument is the id. This can be used if you want to have upgrades split up across multiple subtabs, for example.

  • respec-button, master-button: The respec and master buttons for buyables and clickables, respectively.

  • sell-one, sell-all: The "sell one" and "sell all" for buyables, respectively. The argument is the id of the buyable.

- + \ No newline at end of file diff --git a/public/kronos/docs/getting-started.html b/public/kronos/docs/getting-started.html index 78bb9471..37bdfeac 100644 --- a/public/kronos/docs/getting-started.html +++ b/public/kronos/docs/getting-started.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Getting started ​

Welcome to The Modding Tree!

Using the Modding Tree, at its simplest level, just requires getting a copy of it onto your computer. However, if you do it the right way, it will help in many ways.

Don't let the word "Github" scare you away. It's actually much easier to use than most people think, especially because most people use it the hard way. The key is Github Desktop, which lets you do everything you need to, without even touching the command line.

The benefits of using Github:

  • It makes it much, much easier to update The Modding Tree.
  • You can share your work without any extra effort using githack, or with a bit more effort, set up a github.io site.
  • It lets you undo changes to your code, and to have multiple versions of it.
  • It lets you collaborate with other people, if you want to.

Getting set up with Github Desktop, Visual Studio Code, and The Modding Tree: ​

  1. Install Github Desktop and Visual Studio Code.

  2. Make a Github account. You can handle this on your own.

  3. Log in on your browser, and go back to The Modding Tree page. At the top right, there should be a button that says "fork". Click on it, and then on your username. You now have your own fork, or copy, of The Modding Tree.

  4. Open Github Desktop and log in. Ignore everything else and choose "clone a repository". A "repository" is basically a "Github project", like The Modding Tree. "Cloning" is downloading a copy of the repository to your computer.

  5. Look for The Modding Tree in the list of repositiories (it should be the only one) and click "clone".

  6. Select that you're using it for your own purposes, and click continue. It will download the files and handle everything.

Using your repository ​

  1. Click on "show in explorer/finder" to the right, and then open the index.html file in the folder. The page should open up on your browser. This will let you view and test your project locally!

  2. To edit your project, click "open in VSCode" in Github Desktop.

  3. Open mod.js in VSCode, and look at the top part where it has a "modInfo" object. Fill in your mod's name to whatever you want, and change the id as well. (It can be any string value, and it's used to determine where the savefile is. Make it something that's probably unique, and don't change it again later or else it'll effectively wipe existing saves)

  4. Save mod.js, and then reload index.html in your browser. The title on the tab, as well as on the info page, will now be updated! You can reload the page every time you change the code to test it quickly and easily.

  5. Go back to Github Desktop. It's time to save your changes into the git system by making a "commit". This basically saves your work and creates a snapshot of what your code looks like at this moment, allowing you to look back at it later.

  6. At the bottom right corner, add a summary of your changes, and then click "commit to master".

  7. Finally, at the top middle, click "push origin" to push your changes out onto the online repository.

  8. You can view your project on line, or share it with others, by going to https://raw.githack.com/[YOUR-GITHUB-USERNAME]/The-Modding-Tree/master/index.html

And now, you have successfully used Github! You can look at the documentation to see how The Modding Tree's system works and to make your mod a reality.

- + \ No newline at end of file diff --git a/public/kronos/docs/grids.html b/public/kronos/docs/grids.html index ff376419..982d79a1 100644 --- a/public/kronos/docs/grids.html +++ b/public/kronos/docs/grids.html @@ -8,10 +8,10 @@ - + - + @@ -330,7 +330,7 @@ etc }

Features:

  • rows, cols: The amount of rows and columns of gridable to display.

  • maxRows, maxCols: sometimes needed. If rows or cols are dynamic, you need to define the maximum amount that there can be (you can increase it when you update the game though). These CANNOT be dynamic.

  • getStartData(id): Creates the default data for the gridable at this position. This can be an object, or a regular value.

  • getUnlocked(id): optional. Returns true if the gridable at this position should be visible.

  • getTitle(data, id): optional. Returns text that should displayed at the top in a larger font, based on the position and data of the gridable.

  • getDisplay(data, id): optional. Returns everything that should be displayed on the gridable after the title, based on the position and data of the gridable.

  • getStyle(data, id): optional. Returns CSS to apply to this gridable, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • getCanClick(data, id): optional. A function returning a bool to determine if you can click a gridable, based on its data and position. If absent, you can always click it.

  • onClick(data, id): A function that implements clicking on the gridable, based on its position and data.

  • onHold(data, id): optional A function that is called 20x/sec when the button is held for at least 0.25 seconds.

  • getEffect(data, id): optional. A function that calculates and returns a gridable's effect, based on its position and data. (Whatever that means for a gridable)

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar.

- + \ No newline at end of file diff --git a/public/kronos/docs/infoboxes.html b/public/kronos/docs/infoboxes.html index 2940fff8..6cab6774 100644 --- a/public/kronos/docs/infoboxes.html +++ b/public/kronos/docs/infoboxes.html @@ -8,10 +8,10 @@ - + - + @@ -317,7 +317,7 @@ }, etc }

Features:

  • title: The text displayed above the main box. Can be a function to be dynamic, and can use basic HTML.

  • body: The text displayed inside the box. Can be a function to be dynamic, and can use basic HTML.

  • style, titleStyle, bodyStyle: optional. Apply CSS to the infobox, or to the title button or body of the infobox, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • unlocked(): optional. A function returning a bool to determine if the infobox is visible or not. Default is unlocked.

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar

  • id: assigned automagically. It's the "key" which the bar was stored under, for convenient access. The infobox in the example's id is "lore".

- + \ No newline at end of file diff --git a/public/kronos/docs/layer-features.html b/public/kronos/docs/layer-features.html index a5cdcc67..463cb482 100644 --- a/public/kronos/docs/layer-features.html +++ b/public/kronos/docs/layer-features.html @@ -8,10 +8,10 @@ - + - + @@ -320,7 +320,7 @@ "challenge"() { return {'height': '200px'} }, "prestige-button"() { return {'color': '#AA66AA'} } }
  • deactivated: optional, if this is true, hasUpgrade, hasChallenge, hasAchievement, and hasMilestone will return false for things in the layer, and you will be unable to buy or click things on the layer. You will have to disable effects of buyables, the innate layer effect, and possibly other things yourself.

Custom Prestige type ​

(All of these can also be used by other prestige types)

  • getResetGain(): mostly for custom prestige type. Returns how many points you should get if you reset now. You can call getResetGain(this.layer, useType = "static") or similar to calculate what your gain would be under another prestige type (provided you have all of the required features in the layer).

  • getNextAt(canMax=false): mostly for custom prestige type. Returns how many of the base currency you need to get to the next point. canMax is an optional variable used with Static-ish layers to differentiate between if it's looking for the first point you can reset at, or the requirement for any gain at all (Supporting both is good). You can also call getNextAt(this.layer, canMax=false, useType = "static") or similar to calculate what your next at would be under another prestige type (provided you have all of the required features in the layer).

  • canReset(): mostly for custom prestige type. Return true only if you have the resources required to do a prestige here.

  • prestigeNotify(): mostly for custom prestige types, returns true if this layer should be subtly highlighted to indicate you can prestige for a meaningful gain.

- + \ No newline at end of file diff --git a/public/kronos/docs/main-mod-info.html b/public/kronos/docs/main-mod-info.html index d15a2d6c..a6a57fa9 100644 --- a/public/kronos/docs/main-mod-info.html +++ b/public/kronos/docs/main-mod-info.html @@ -8,10 +8,10 @@ - + - + @@ -314,7 +314,7 @@ weather: "Yes", happiness: new Decimal(72), }}

  • displayThings: An array of functions used to display extra things at the top of the tree tab. Each function returns a string, which is a line to display (with basic HTML support). If a function returns nothing, nothing is displayed (and it doesn't take up a line).

  • isEndgame(): A function to determine if the player has reached the end of the game, at which point the "you win!" screen appears.

Less important things beyond this point!

  • maxTickLength(): Returns the maximum tick length, in milliseconds. Only really useful if you have something that reduces over time, which long ticks mess up (usually a challenge).

  • fixOldSave(): Can be used to modify a save file when loading into a new version of the game. Use this to undo inflation, never forcibly hard reset your players.

- + \ No newline at end of file diff --git a/public/kronos/docs/milestones.html b/public/kronos/docs/milestones.html index cb25cf70..d55acfb0 100644 --- a/public/kronos/docs/milestones.html +++ b/public/kronos/docs/milestones.html @@ -8,10 +8,10 @@ - + - + @@ -317,7 +317,7 @@ } etc }

You can use hasMilestone(layer, id) to determine if the player has a given milestone

Milestone features:

  • requirementDescription: A string describing the requirement for unlocking this milestone. Suggestion: Use a "total". It can also be a function that returns updating text. Can use basic HTML.

  • effectDescription: A string describing the reward for having the milestone. You will have to implement the reward elsewhere. It can also be a function that returns updating text. Can use basic HTML.

  • done(): A function returning a boolean to determine if the milestone should be awarded.

  • toggles: optional. Creates toggle buttons that appear on the milestone when it is unlocked. The toggles can toggle a given boolean value in a layer. It is defined as an array of paired items, one pair per toggle. The first is the internal name of the layer the value being toggled is stored in, and the second is the internal name of the variable to toggle. (e.g. [["b", "auto"], ["g", "auto"])

    Tip: Toggles are not de-set if the milestone becomes locked! In this case, you should also check if the player has the milestone.

  • style: optional. Applies CSS to this milestone, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • unlocked(): optional. A function returning a boolean to determine if the milestone should be shown. If absent, it is always shown.

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar.

  • id: assigned automagically. It's the "key" which the milestone was stored under, for convenient access. The milestone in the example's id is 0.

Disaable milestone popups by adding milestonePopups: false to the layer.

- + \ No newline at end of file diff --git a/public/kronos/docs/particles.html b/public/kronos/docs/particles.html index 79ea09b9..9b2ce60e 100644 --- a/public/kronos/docs/particles.html +++ b/public/kronos/docs/particles.html @@ -8,10 +8,10 @@ - + - + @@ -320,7 +320,7 @@ }, etc... }

Features can be functions or constant. These features will be called when each particle is made, with an id argument, which is assigned based on which of the amount particles being spawned this is. All of these are optional, with a default value.

All distances are in pixels and angles are in degrees, with 0 being up and going clockwise.

  • time: The amount of time, in seconds, that the particle will last. Default is 3.

  • fadeOutTime: The amount of seconds that fading out at the end should take (part of the total lifetime). Default is 1.

  • fadeInTime: The amount of seconds that fading in should take (part of the total lifetime). Default is 0.

  • image: The image the particle should display. "" will display no image. Default is a generic particle.

  • text: Displays text on the particle. Can use basic HTML.

  • style: Lets you apply other CSS styling to the particle.

  • width, height: The dimensions of the particle. Default is 35 and 35.

  • color: Sets the color of the image to this color.

  • angle: The angle that the particle should face. Default is 0.

  • dir: The initial angle that the particles should move in, before spread is factored in. Default is whatever angle is.

  • spread: If there are several particles, they will be spread out by this many degrees, centered on dir. Default is 30.

  • rotation: The amount that the (visual) angle of the particle should change by. Default is 0.

  • speed: The starting speed of the particle. Default is 15.

  • gravity: The amount the particle should accelerate downwards. Default is 0.

  • x, y: The starting coordinates of the particle. Default is at the mouse position.

  • offset: How far from the start each particle should appear. Default is 10.

  • xVel, yVel: Set initially based on other properties, then used to update movement.

  • layer: When changing tabs, if leaving the layer tab, this particle will be erased.

  • You can add other features to particles, but you must impliment their effects yourself.

Function features: These stay as functions and are for more advanced things. They are optional.

  • update(): Called each tick. Lets you do more advanced visual and movement behaviors by changing other properties.
  • onClick(), onMouseOver(), onMouseLeave(): Called when the particle is interacted with.

Other useful things that are not features of the particle object:

  • setDir(particle, dir), setSpeed(particle, speed): Set the speed/direction on a particle.
  • clearParticles(check): Function to delete particles. With no check, it deletes all particles. Check is a function that takes a particle, and returns true if that particle should be deleted.
  • You can use Vue.delete(particles, this.id) to make a particle delete itself.
  • mouseX and mouseY are variables that track the mouse position.
  • sin(x), cos(x), tan(x): functions that do these operations, with x in degrees. (Instead of radians).
  • asin(x), acos(x), atan(x): functions that do these operations, with the returned value in degrees. (instead of radians).
- + \ No newline at end of file diff --git a/public/kronos/docs/subtabs-and-microtabs.html b/public/kronos/docs/subtabs-and-microtabs.html index 8cedb319..d4b1490a 100644 --- a/public/kronos/docs/subtabs-and-microtabs.html +++ b/public/kronos/docs/subtabs-and-microtabs.html @@ -8,10 +8,10 @@ - + - + @@ -334,7 +334,7 @@ // There could be another set of microtabs here } }

Normal subtabs and microtab subtabs both use the same features:

Features: ​

  • content: The tab layout code for the subtab, in the tab layout format.

  • style: optional. Applies CSS to the whole subtab when switched to, in the form of an "CSS Object", where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • buttonStyle: optional. A CSS object, which affects the appearance of the button for that subtab.

  • unlocked(): optional. a function to determine if the button for this subtab should be visible. By default, a subtab is always unlocked. You can't use the "this" keyword in this function.

  • shouldNotify()/prestigeNotify(): optional, if true, the tab button will be highlighted to notify the player that there is something there.

  • glowColor: optional, specifies the color that the subtab glows. If this subtab is causing the main layer to node glow (and it would't otherwise) the node also glows this color. Is NOT overridden by embedding a layer.

  • embedLayer: SIGNIFICANT, the id of another layer. If you have this, it will override "content", "style" and "shouldNotify", instead displaying the entire layer in the subtab.

- + \ No newline at end of file diff --git a/public/kronos/docs/trees-and-tree-customization.html b/public/kronos/docs/trees-and-tree-customization.html index 8ac7264a..788964a2 100644 --- a/public/kronos/docs/trees-and-tree-customization.html +++ b/public/kronos/docs/trees-and-tree-customization.html @@ -8,10 +8,10 @@ - + - + @@ -312,7 +312,7 @@

Trees and tree customization ​

If you want to have something beyond the standard tree on the left tab, you can do that in tree.js. You can change the layout of the tree, including making non-layer nodes, change it into something other than a tree, or hide the left tab altogether. This also introduces the "tree" component, which can be used in your layers as well.

layoutInfo ​

The most important part is layoutInfo, containing:

  • startTab: The id of the default tab to show on the left at the start.
  • showTree: True if the tree tab should be shown at the start of the game. (The other tab will fill the whole page)
  • treeLayout: If present, overrides the tree layout and places nodes as you describe instead (explained in the next section).

Additionally, if you want the main layout to not be a tree, you can edit the "tree-tab" layer at the bottom of tree.js to modify it just like a normal layer's tab. You can even switch between left tabs, using showNavTab(layer) to make that layer appear on the left.

Trees ​

The tree component is defined as an array of arrays of names of layers or nodes to show in the tree. They work just like layers/ nodes in the main tree (but branches between nodes will only work on the first node if you have duplicates.)

Here is an example tree:

js
[["p"],
  ["left", "blank", "right", "blank"]
  ["a", "b", "blank", "c", "weirdButton"]]

Nodes ​

Nodes are non-layer buttons that can go in trees. They are defined similarly to layers, but with addNode instead of addLayer.

Features:

  • color: optional, The node's color. (A string in hex format with a #)

  • symbol: optional The text on the button (The id capitalized by default)

  • canClick(): Returns true if the player can click the node. ()

  • onClick(): The function called when the node is clicked.

  • layerShown(): optional, A function returning a bool which determines if this node should be visible. It can also return "ghost", which will hide the layer, but its node will still take up space in its tree.

  • branches: optional. An array of layer/node ids. On a tree, a line will appear from this node to all of the nodes in the list. Alternatively, an entry in the array can be a 2-element array consisting of the id and a color value. The color value can either be a string with a hex color code, or a number from 1-3 (theme-affected colors).

  • nodeStyle: optional. A CSS object, where the keys are CSS attributes, which styles this node on the tree.

  • tooltip() / tooltipLocked(): optional. Functions that return text, which is the tooltip for the node when the layer is unlocked or locked, respectively. By default the tooltips behave the same as in the original Prestige Tree.

  • row: optional, the row that this node appears in (for the default tree).

  • position: optional, Determines the horizontal position of the layer in its row in a default tree. By default, it uses the id, and layers/nodes are sorted in alphabetical order.

- + \ No newline at end of file diff --git a/public/kronos/docs/updating-tmt.html b/public/kronos/docs/updating-tmt.html index f99dc711..ef4d4e84 100644 --- a/public/kronos/docs/updating-tmt.html +++ b/public/kronos/docs/updating-tmt.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Updating The Modding Tree ​

This tutorial assumes that you have used the Getting Started Tutorial, and are using Github Desktop and VSCode for your mod.

Here's what you have to do when there's a TMT update:

  1. Look at the changelog. It will warn you if the update will break anything or require any changes. Decide if you want to try to update.

  2. Open Github Desktop, and at the top middle, click "fetch origin". This will make Github Desktop get information about the update.

  3. Click where it says "current branch: master" at the top middle, and at the bottom of the thing that appears, click "choose a branch to merge into master".

  4. Select upstream/master. It will likely say there are conflicts, but you have tools to resolve them. Click "Merge upstream/master into master".

  5. A conflict happens when the things you're trying to merge have both made changes in the same place. Click "open in Visual Studio Code" next to the first file.

  6. Scroll down through the file, and look for the parts highlighted in red and green. One of these is your code, and the other is some code that will be modified by the update. Do your best to try to edit things to keep the updated changes, but keep your content.

  7. Continue to do this for all remaining changes.

  8. Do any other changes required by the update, run the game, fix issues, etc.

- + \ No newline at end of file diff --git a/public/kronos/docs/upgrades.html b/public/kronos/docs/upgrades.html index de521690..3910a890 100644 --- a/public/kronos/docs/upgrades.html +++ b/public/kronos/docs/upgrades.html @@ -8,10 +8,10 @@ - + - + @@ -317,7 +317,7 @@ }, etc }

Usually, upgrades should have an id where the first digit is the row and the second digit is the column.

Individual upgrades can have these features:

  • title: optional. Displayed at the top in a larger font. It can also be a function that returns updating text. Can use basic HTML.

  • description: A description of the upgrade's effect. You will also have to implement the effect where it is applied. It can also be a function that returns updating text. Can use basic HTML.

  • effect(): optional. A function that calculates and returns the current values of any bonuses from the upgrade. Can return a value or an object containing multiple values.

  • effectDisplay(): optional. A function that returns a display of the current effects of the upgrade with formatting. Default displays nothing. Can use basic HTML.

  • fullDisplay(): OVERRIDE. Overrides the other displays and descriptions, and lets you set the full text for the upgrade. Can use basic HTML.

  • cost: A Decimal for the cost of the upgrade. By default, upgrades cost the main prestige currency for the layer.

  • unlocked(): optional. A function returning a bool to determine if the upgrade is visible or not. Default is unlocked.

  • onPurchase(): optional. This function will be called when the upgrade is purchased. Good for upgrades like "makes this layer act like it was unlocked first".

  • style: optional. Applies CSS to this upgrade, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar.

  • id: assigned automagically. It's the "key" which the upgrade was stored under, for convenient access. The upgrade in the example's id is 11.

By default, upgrades use the main prestige currency for the layer. You can include these to change them (but it needs to be a Decimal):

  • currencyDisplayName: optional. The name to display for the currency for the upgrade.

  • currencyInternalName: optional. The internal name for that currency.

  • currencyLayer: optional. The internal name of the layer that currency is stored in. If it's not in a layer (like Points), omit. If it's not stored directly in a layer, instead use the next feature.

  • currencyLocation: optional. If your currency is stored in something inside a layer (e.g. a buyable's amount), you can access it this way. This is a function returning the object in "player" that contains the value (like player[this.layer].buyables)

If you want to do something more complicated like upgrades that cost two currencies, you can override the purchase system with these (and you need to use fullDisplay as well)

  • canAfford(): OVERRIDE, a function determining if you are able to buy the upgrade

  • pay(): OVERRIDE, a function that reduces your currencies when you buy the upgrade

- + \ No newline at end of file diff --git a/public/lit/Old Things/2.0-format-changes.html b/public/lit/Old Things/2.0-format-changes.html index 20d2a86a..71bc0f6a 100644 --- a/public/lit/Old Things/2.0-format-changes.html +++ b/public/lit/Old Things/2.0-format-changes.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

2.0 format changes ​

  • Temp format is changed from temp.something[layer] to temp[layer].something, for consistency
  • Challenges are now saved as an object with the amount of completions in each spot. (This will break saves.)
  • effectDisplay in Challenges and Upgrades no longer takes an argument, and neither does effect for Buyables
  • Buyable cost can take an argument for amount of buyables, but it needs to function if no argument is supplied (it should do the cost for the next purchase).
  • Generation of Points now happens in the main game loop (not in a layer update function), enabled by canGenPoints in game.js.
  • Changed fullLayerReset to layerDataReset, which takes an array of names of values to keep

In addition, many names were changed, mostly expanding abbreviations:

All instances of:

  • chall -> challenge
  • unl -> unlocked
  • upg -> upgrade (besides CSS)
  • amt -> amount
  • desc -> description
  • resCeil -> roundUpCost
  • order -> unlockOrder
  • incr_order -> increaseUnlockOrder

Challenges:

  • desc -> challengeDescription
  • reward -> rewardDescription
  • effect -> rewardEffect
  • effectDisplay -> rewardDisplay
  • active -> challengeActive
- + \ No newline at end of file diff --git a/public/lit/README.html b/public/lit/README.html index 07ff4514..b8638cca 100644 --- a/public/lit/README.html +++ b/public/lit/README.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Kronos ​

Play here.

Updating the website:

  • git submodule update --remote
  • git add -A
  • git commit -m "Updated kronos"
  • git push
- + \ No newline at end of file diff --git a/public/lit/changelog.html b/public/lit/changelog.html index 0e985004..4debc415 100644 --- a/public/lit/changelog.html +++ b/public/lit/changelog.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

The Modding Tree changelog: ​

v2.π: Incrementally Updated - 2/5/21 ​

  • Performance improvements.
  • Fixed tooltips overlapping with the top display.
  • Clicking a popup dismisses it immediately.
  • Added support for bulk challenge completions.
  • "Best" is updated automatically.
  • Fixed keeping Decimal values on reset.
  • Code reorganization and style improvements by fudo.

v2.3.5 - 12/21/20 ​

  • Added resetTime, which tracks the time since a layer prestiged or was reset.
  • A layer node will be highlighted red if one of its subtabs is highlighted red.
  • Fixed issues with keeping challenges, buyables, and clickables on reset.
  • Improved the unlocking of custom layers.
  • Other minor fixes.

v2.3.4 - 12/16/20 ​

  • Added a node image feature.
  • Resource display now always shows the amount of the currency the layer's gain is based on.
  • Added spacing between tree nodes.
  • Another attempt to fix tooltip flickering.

v2.3.3 - 12/13/20 ​

  • Fixed the first node in a row always taking up space.
  • layerShown is now optional.
  • All prestige types can now use features for custom prestige types.

v2.3.2 - 12/13/20 ​

  • Fixed achievement/milestone popups.

v2.3.1 - 12/12/20 ​

  • Another attempt to fix flickering tooltips.
  • The "this" keyword should work everywhere except tabFormat arrays (although I may have missed some things).
  • Fixed tree branches not updating when scrolling on the right-side tab.
  • Fixed a spacing issue when a node's symbol is ""
  • Removed some old, unneeded files.

v2.3: Cooler and Newer Edition - 12/10/20 ​

  • Added achievement/milestone popups (thank you to Jacorb for this contribution!)
  • The changelog tab is back, and can be set in mod.js.
  • Layer nodes and respec buttons will not be clicked by pressing "enter".
  • Possible fix for flickering tooltips and strange transitions.
  • The victory screen text is configurable.
  • Added image and textStyle features to achievements.
  • Added an argument to use specific rows in an "upgrades" component.
  • Fixed the comma appearing in the main display when there was no effectDescription
  • Added the ability to easily make a tab that is a collection of layers in subtabs.
  • Improved spacing for embedding layers with subtabs into subtabs.

v2.2.8 - 12/03/20 ​

  • Double-clicking a layer node brings you to the main subtab for that layer.
  • Attempted to fix challenges visually updating a different way.
  • Added a softcap function for use in formulas.
  • Added displayRow feature, which lets layers be shown somewhere separate from where they are in the reset order (e.g. side layers)
  • Fixed autoupgrade issue.

v2.2.7 - 11/30/20 ​

  • Added autoUpgrade feature.
  • resource-display now shows resource gain per second if passiveGain is active.
  • Fixed formatting issues on some large numbers.
  • Better support for using classed objects in player and in layers/tmp.
  • Made hard resetting more effective.
  • Removed Herobrine from getStartClickables.

v2.2.6 - 11/30/20 ​

  • Added goalDescription for challenges and made the new "canComplete" system the standard.
  • Another attempt to fix challenges not visually updating.
  • Fixed side layers not appearing.
  • Fixed getStartClickables again.

v2.2.5 - 11/29/20 ​

  • Added features for overriding the displays and costs/goals of upgrades and challenges to make them fully custom.
  • best, total, and unlocked are always automatically added to layerData (but best and total will only display if you add them yourself).
  • Fixed getStartClickables.

v2.2.4 - 11/28/20 ​

  • Added softcap and softcapPower features (for Normal layers)
  • Offline time limit and default max tick length were fixed (previously the limits were 1000x too large)
  • Added fixOldSaves.
  • You can use HTML in main-display.
  • Fixed a number of minor oddities.

v2.2.3 - 11/28/20 ​

  • Layers will be highlighted if you can finish a challenge.
  • The "can complete challenge" color now overrides the "already completed" color.
  • Button nodes now work as side "layers".
  • Setting a tooltip to "" hides it entirely.

v2.2.2 - 11/22/20 ​

  • Fixed right half of the screen being unclickable in some circumstances.
  • Fixed tree branches being offset.
  • Fix to lastSafeTab.

v2.2.1 - 11/7/20 ​

  • Added a small highlight to layers you can meaningfully prestige on.
  • Added passiveGeneration and autoPrestige features to standardize prestige automation. (The old ways still work, but the new ones work better with other things)
  • Improved milestones visually a bit.
  • "best" and "total" are now only displayed if present in startData.
  • Fixed issues with things not updating visually. (Thank you to to Jacorb!)
  • Side layers and button nodes can now be highlighted.
  • Updated docs on the new tree-related features.

v2.2: Uprooted - 11/7/20 ​

  • You can now embed a layer inside of a subtab or microtab!
  • Added support for hiding or reformatting the tree tab
  • Added non-layer button nodes
  • Added shouldNotify to subtab/microtab buttons. (You can make them highlighted)
  • Added commas to large exponents.
  • Upgrades now only show "currently" if they have an effectDisplay (so not for constant effects).
  • Achievements are part of the default tab format.
  • NaN is now handled more intelligently.
  • Renamed files, and moved less relevant ones to another folder.
  • The "hide completed challenges" setting now only hides challenges at max completions.
  • Thank you to thepaperpilot for fixing errors in docs and improving the infobox appearance!
  • Many other minor fixes.

v2.1.4 - 10/25/20 ​

  • Added an infobox component. Thank you to thepaperpilot for this contribution!
  • Layer type is now optional, and defaults to "none".
  • Improved the look of bars and tab buttons.
  • Improved spacing between layer nodes (also thanks to thepaperpilot!)
  • Fixed the "blank" component breaking if only specifying the height.
  • Fixed some numbers not displaying with enough digits.
  • Made a few more things able to be functions.
  • A few other minor fixes.

v2.1.3.1 - 10/21/20 ​

  • Fixed the update function.

v2.1.3 - 10/21/20 ​

  • gainMult and gainExp are now optional.
  • Layer unlocking is now kept on reset.
  • Game should start up faster.
  • Layer updates now have a determined order and starts with earlier-rowed layers.
  • Automation now has a determined order and starts with later-rowed layers.
  • Fixed issues with resetting clickables and challenges.
  • Commas should no longer appear in the decimal places of a number.
  • Fixed potential issue in displaying the tree.

v2.1.2 - 10/19/20 ​

  • Added buyUpgrade function (buyUpg still works though)
  • Added author name to modInfo.
  • Fix to crash caused when the name of a subtab or microtab is changed.
  • Fixes to outdated information in docs.
  • Improvements to Discord links.
  • Thank you to thepaperpilot for contributing to this update!

v2.1.1 - 10/17/20 ​

  • Added resource-display component, which displays the base currency for the prestige layer, as well as the best and/or total of this layer's prestige currency.
  • Fixed the value for the base currency not updating in resource-display.

v2.1: We should have thought of this sooner! - 10/17/20 ​

  • Moved most of the code users will want to edit to mod.js, added documentation for it.
    • Specifically, modInfo, VERSION, canGenPoints, getPointGen, and maxTickLength
  • Added getStartPoints()
  • Added the ability to store non-layer-related data
  • Added the ability to display more things at the top of the tree tab below points.
  • Made the endgame condition customizable
  • Added "sell one" and "sell all" buttons for buyables.
  • Moved the old "game" to demo.js, and replaced it with a minimal game that won't cause issues when edited.
  • Fixed issues with version number
  • Fixed number formatting issue making things like "10e9" appear.

v2.0.5 - 10/16/20 ​

  • Made more features (including prestige parameters) able to be dynamic.
  • Layer nodes can be hidden but still take up space with "ghost" visibility
  • Added clickableEffect for real.
  • Fixed some visual issues with bars.
  • A few other minor tweaks and improvements.

v2.0.4 - 10/16/20 ​

  • Fixed HTML on buttons interfering with clicking on them.

v2.0.3 - 10/16/20 ​

  • Fixed hotkeys not displaying in info.
  • Fixed the game supressing all external hotkeys.
  • You can use more things as currencies for upgrade costs and challenge goals using currencyLocation.
  • Added maxTickLength, which can be used to prevent offline time or tab-switching from breaking time-limit based mechanics.
  • Made buyable respec buttons and clickable "master" buttons their own components, and gave them a hide/show feature.
  • Added a general "tooltip" feature for achievements.

v2.0.2 - 10/15/20 ​

  • Branches are now dynamic (they can be functions).
  • Fixed a crash related to offline time.
  • Fixed links being too wide.

v2.0.1 - 10/15/20 ​

  • Fixed side layers appearing multiple times.

v2.0: The Pinnacle of Achievement Mountain - 10/15/20 ​

  • Added progress bars, which are highly customizable and can be horizontal or vertical!
  • Added "side layers", displayed smaller and off to the side, and don't get reset by default. They can be used for global achievements and statistics. Speaking of which...
  • Added achievements!
  • Added clickables, a more generalized variant of buyables.
  • Almost every value in layer data can be either a function or a constant value!
  • Added support for multiple completions of challenges.
  • Added "none" prestige type, which removes the need for any other prestige-related features.
  • The points display and other gui elements stay at the top of the screen when the tree scrolls.
  • Added getter/setter functions for the amounts and effects of most Big Features
  • Moved modInfo to game.js, added a spot in modInfo for a Discord link, changelog link. Also added a separate mod version from the TMT version in VERSION.
  • Tree structure is based on layer data, no index.html editing is needed.
  • Tmp does not need to be manually updated.
  • You don't have to have the same amount of upgrades in every row (and challs and buyables)
  • "unlocked" is optional for all Big Components (defaults to true).
  • All displays will update correctly.
  • Changelog is no longer in index.html at all.
  • Generation of Points now happens in the main game loop
  • Changed the reset functions to make keeping things easier
  • Renamed many things to increase readability (see the list in the link below)
  • Improved documentation based on feedback

v1.3.5: ​

  • Completely automated convertToDecimal, now you never have to worry about it again.
  • Branches can be defined without a color id. But they can also use hex values for color ids!
  • Created a tutorial for getting started with TMT and Github.
  • Page title is now automatically taken from mod name.

v1.3.4 - 10/8/20 ​

  • Added "midsection" feature to add things to a tab's layout while still keeping the standard layout.
  • Fix for being able to buy more buyables than you should.

v1.3.3 - 10/7/20 ​

  • Fix for the "order of operations" issue in temp.

v1.3.1 - 10/7/20 ​

  • Added custom CSS and tooltips for Layer Nodes.
  • Added custom CSS for upgrades, buyables, milestones, and challenges, both individually and layer-wide.
  • You can now use HTML in most display text!
  • You can now make milestones unlockable and not display immediately.
  • Fixed importing saves, and issue with upgrades not appearing, and probably more.
  • Optional "name" layer feature, used in confirmation messages.

v1.3: Tabception... ception! - 10/7/20 ​

  • Added subtabs! And also a Micro-tab component to let you make smaller subtab-esque areas anywhere.
  • Added a "custom" prestige formula type, and a number of features to support it.
  • Added points/sec display (can be disabled).
  • Added h-line, v-line and image-display components, plus components for individual upgrades, challenges, and milestones.
  • Added upgEffect, buyableEffect, and challEffect functions.
  • Added "hide completed challenges" setting.
  • Moved old changelogs to a separate place.
  • Fixed hasMilestone and incr_order.
  • Static layers now show the currency amount needed for the next one if you can buy max.

v1.2.4 - 10/4/20 ​

  • Layers are now highlighted if you can buy an upgrade, and a new feature, shouldNotify, lets you make it highlight other ways.
  • Fixed bugs with hasUpg, hasChall, hasMilestone, and inChallenge.
  • Changed the sample code to use the above functions for convenience.

v1.2.3 - 10/3/20 ​

  • Added a row component, which displays a list of objects in a row.
  • Added a column component, which displays a list of objects in a column (useful within a row).
  • Changed blanks to have a customizable width and height.

v1.2: This Changes Everything! - 10/3/20 ​

  • Many layer features can now be static values or functions. (This made some formats change, which will break old things)
  • You can now use the "this" keyword, to make code easier to transfer when making new layers.
  • Also added "this.layer", which is the current layer's name, and works on existing subfeatures (e.g. individual upgrades) as well! Subfeatures also have "this.id".
  • Fixed a big save issue. If you use a unique mod id, your save will never conflict with other mods.
  • Added a configurable offline time limit in modinfo at the top of index.html. (default 1 hour)
  • Added a few minor features, and updated the docs with new information.

v1.1.1: ​

  • You can define hotkeys directly from layer config.

v1.1: Enhanced Edition ​

  • Added "Buyables", which can function like Space Buildings or Enhancers.
  • Custom CSS can now be used on any component! Make the third argument an object with CSS parameters.
  • Lots of minor good things.

v1.0: ​

  • First release.
- + \ No newline at end of file diff --git a/public/lit/docs/!general-info.html b/public/lit/docs/!general-info.html index ef55556b..9a0b515a 100644 --- a/public/lit/docs/!general-info.html +++ b/public/lit/docs/!general-info.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

The-Modding-Tree ​

The main way to add content is through creating layers. You can either add a layer directly in the layers object in layerSupport.js, or declare it in another file and register it by calling addLayer(layername, layerdata). There is an example layer registration in layers.js showing the recommended method. It is just an example and can be freely deleted. You can also use it as a reference or a base for your own layers.

The first thing you need to do is fill out the modInfo object at the top of mod.js to set your mod's name, ID (a string), and other information. A unique modId will prevent your mod's saves from conflicting with other mods. Note that changing this after people have started playing will reset their saves.

Most of the time, you won't need to dive deep into the code to create things, but you still can if you really want to, for example to add new Vue components in v.js.

The Modding Tree uses break_eternity.js to store large values. This means that many numbers are Decimal objects, and must be treated differently. For example, you have to use new Decimal(x) to create a Decimal value instead of a plain number, and perform operations on them by calling functions. e.g, instead of x = x + y, use x = x.add(y). Keep in mind this also applies to comparison operators, which should be replaced with calling the .gt, .gte, .lt, .lte, .eq, and .neq functions. See the break_eternity.js docs for more details on working with Decimal values.

Almost all values can be either a constant value, or a dynamic value. Dynamic values are defined by putting a function that returns what the value should be at any given time.

All display text can use basic HTML elements (But you can't use most Vue features there).

While reading this documentation, the following key will be used when describing features:

  • No label: This is required and the game may crash if it isn't included.
  • sometimes required: This is may be required, depending on other things in the layer.
  • optional: You can leave this out if you don't intend to use that feature for the layer.
  • assigned automagically: This value will be set automatically and override any value you set.
  • deprecated: This feature is not recommended to be used anymore, and may be removed in future versions of TMT.

Table of Contents ​

General ​

  • Getting Started: Getting your own copy of the code set up with Github Desktop.
  • Main mod info: How to set up general things for your mod in mod.js.
  • Basic layer breakdown: Breaking down the components of a layer with minimal features.
  • Layer features: Explanations of all of the different properties that you can give a layer.
  • Custom Tab Layouts: An optional way to give your tabs a different layout. You can even create entirely new components to use.
  • Custom game layouts: You can get rid of the tree tab, add buttons and other things to the tree, or even customize the tab's layout like a layer tab.
  • Updating TMT: Using Github Desktop to update your mod's version of TMT.

Common components ​

  • Upgrades: How to create upgrades for a layer.
  • Milestones: How to create milestones for a layer.
  • Buyables: Create rebuyable upgrades for your layer (with the option to make them respec-able). Can be used to make Enhancers or Space Buildings.
  • Clickables: A more generalized variant of buyables, for any kind of thing that is sometimes clickable. Between these and Buyables, you can do just about anything.

Other components and features ​

  • Challenges: How to create challenges for a layer.
  • Bars: Display some information as a progress bar, gauge, or similar. They are highly customizable, and can be horizontal and vertical as well.
  • Subtabs and Microtabs: Create subtabs for your tabs, as well as "microtab" components that you can put inside the tabs. You can even use them to embed a layer inside another layer!
  • Achievements: How to create achievements for a layer (or for the whole game).
  • Infoboxes: Boxes containing text that can be shown or hidden.
  • Trees: Make your own trees. You can make non-layer button nodes too!
- + \ No newline at end of file diff --git a/public/lit/docs/achievements.html b/public/lit/docs/achievements.html index 40c020eb..726afbff 100644 --- a/public/lit/docs/achievements.html +++ b/public/lit/docs/achievements.html @@ -8,10 +8,10 @@ - + - + @@ -318,7 +318,7 @@ }, etc }

Each achievement should have an id where the first digit is the row and the second digit is the column.

Individual achievement can have these features:

  • name: optional. displayed at the top of the achievement. The only visible text. It can also be a function that returns updating text. Can use basic HTML.

  • done(): A function returning a boolean to determine if the achievement should be awarded.

  • tooltip: Default tooltip for the achievement, appears when it is hovered over. Should convey the goal and any reward for completing the achievement. It can also be a function that returns updating text. Can use basic HTML. Setting this to "" disables the tooltip.

  • effect(): optional. A function that calculates and returns the current values of any bonuses from the achievement. Can return a value or an object containing multiple values.

  • unlocked(): optional. A function returning a bool to determine if the achievement is visible or not. Default is unlocked.

  • onComplete() - optional. this function will be called when the achievement is completed.

  • image: optional, puts the image from the given URL (relative or absolute) in the achievement

  • style: optional. Applies CSS to this achievement, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • textStyle: optional. Applies CSS to the text, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar.

  • id: assigned automagically. It's the "key" which the achievement was stored under, for convenient access. The achievement in the example's id is 11.

  • goalTooltip: optional, deprecated. Appears when the achievement is hovered over and locked, overrides the basic tooltip. This is to display the goal (or a hint). It can also be a function that returns updating text. Can use basic HTML.

  • doneTooltip: optional, deprecated. Appears when the achievement is hovered over and completed, overrides the basic tooltip. This can display what the player achieved (the goal), and the rewards, if any. It can also be a function that returns updating text. Can use basic HTML.

Disable achievement popups by adding achievementsPopups: false to the layer.

- + \ No newline at end of file diff --git a/public/lit/docs/bars.html b/public/lit/docs/bars.html index 3b7bed49..ee6f11dd 100644 --- a/public/lit/docs/bars.html +++ b/public/lit/docs/bars.html @@ -8,10 +8,10 @@ - + - + @@ -319,7 +319,7 @@ }, etc }

Features:

  • direction: UP, DOWN, LEFT, or RIGHT (not strings). Determines the direction that the bar is filled as it progresses. RIGHT means from left to right.

  • width, height: The size in pixels of the bar, but as numbers (no "px" at the end).

  • progress(): A function that returns the portion of the bar that is filled, from "empty" at 0 to "full" at 1, updating automatically. (Nothing bad happens if the value goes out of these bounds, and it can be a number or Decimal)

  • display(): optional. A function that returns text to be displayed on top of the bar, can use HTML.

  • unlocked(): optional. A function returning a bool to determine if the bar is visible or not. Default is unlocked.

  • baseStyle, fillStyle, borderStyle, textStyle: Optional, Apply CSS to the unfilled portion, filled portion, border, and display text on the bar, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar.

  • id: assigned automagically. It's the "key" which the bar was stored under, for convenient access. The bar in the example's id is "bigBar".

- + \ No newline at end of file diff --git a/public/lit/docs/basic-layer-breakdown.html b/public/lit/docs/basic-layer-breakdown.html index 09c1d7d1..477735cd 100644 --- a/public/lit/docs/basic-layer-breakdown.html +++ b/public/lit/docs/basic-layer-breakdown.html @@ -8,10 +8,10 @@ - + - + @@ -337,7 +337,7 @@ layerShown() { return true } // Returns a bool for if this layer's node should be visible in the tree. }) - + \ No newline at end of file diff --git a/public/lit/docs/buyables.html b/public/lit/docs/buyables.html index 4904ed99..97cbda4a 100644 --- a/public/lit/docs/buyables.html +++ b/public/lit/docs/buyables.html @@ -8,10 +8,10 @@ - + - + @@ -324,7 +324,7 @@ }, etc }

Features:

  • title: optional. displayed at the top in a larger font. It can also be a function that returns updating text.

  • cost(): cost for buying the next buyable. Can have an optional argument "x" to calculate the cost of the x+1th object, but needs to use "current amount" as a default value for x. (x is a Decimal). Can return an object if there are multiple currencies.

  • effect(): optional. A function that calculates and returns the current values of bonuses of this buyable. Can return a value or an object containing multiple values.

  • display(): A function returning everything that should be displayed on the buyable after the title, likely including the description, amount bought, cost, and current effect. Can use basic HTML.

  • unlocked(): optional. A function returning a bool to determine if the buyable is visible or not. Default is unlocked.

  • canAfford(): A function returning a bool to determine if you can buy one of the buyables.

  • buy(): A function that implements buying one of the buyable, including spending the currency.

  • buyMax(): optional. A function that implements buying as many of the buyable as possible.

  • style: optional. Applies CSS to this buyable, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar.

  • id: assigned automagically. It's the "key" which the buyable was stored under, for convenient access. The buyable in the example's id is 11.

Sell One/Sell All:

Including a sellOne or sellAll function will cause an additional button to appear beneath the buyable. They are functionally identical, but "sell one" appears above "sell all". You can also use them for other things.

  • sellOne/sellAll(): optional. Called when the button is pressed. The standard use would be to decrease/reset the amount of the buyable, and possibly return some currency to the player.

  • canSellOne/canSellAll(): optional. booleans determining whether or not to show the buttons. If "canSellOne/All" is absent but "sellOne/All" is present, the appropriate button will always show.

- + \ No newline at end of file diff --git a/public/lit/docs/challenges.html b/public/lit/docs/challenges.html index b3fbff1b..9330d627 100644 --- a/public/lit/docs/challenges.html +++ b/public/lit/docs/challenges.html @@ -8,10 +8,10 @@ - + - + @@ -320,7 +320,7 @@ }, etc }

Each challenge should have an id where the first digit is the row and the second digit is the column.

Individual Challenges can have these features:

  • name: Name of the challenge, can be a string or a function. Can use basic HTML.

  • challengeDescription: A description of what makes the challenge a challenge. You will need to implement these elsewhere. It can also be a function that returns updating text. Can use basic HTML.

  • goalDescription: A description of the win condition for the challenge. It can also be a function that returns updating text. Can use basic HTML. (Optional if using the old goal system)

  • canComplete(): A function that returns true if you meet the win condition for the challenge. Returning a number will allow bulk completing the challenge. (Optional if using the old goal system)

  • rewardDescription: A description of the reward's effect. You will also have to implement the effect where it is applied. It can also be a function that returns updating text. Can use basic HTML.

  • rewardEffect(): optional. A function that calculates and returns the current values of any bonuses from the reward. Can return a value or an object containing multiple values. Can use basic HTML.

  • rewardDisplay(): optional. A function that returns a display of the current effects of the reward with formatting. Default behavior is to just display the a number appropriately formatted.

  • fullDisplay(): OVERRIDE. Overrides the other displays and descriptions, and lets you set the full text for the challenge. Can use basic HTML.

  • unlocked(): optional. A function returning a bool to determine if the challenge is visible or not. Default is unlocked.

  • onComplete() - optional. this function will be called when the challenge is completed when previously incomplete.

  • countsAs: optional. If a challenge combines the effects of other challenges in this layer, you can use this. An array of challenge ids. The player is effectively in all of those challenges when in the current one.

  • completionLimit: optional. the amount of times you can complete this challenge. Default is 1 completion.

  • style: optional. Applies CSS to this challenge, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar

  • id: assigned automagically. It's the "key" which the challenge was stored under, for convenient access. The challenge in the example's id is 11.

The old goal system uses these features:

  • goal: deprecated, A Decimal for the amount of currency required to beat the challenge. By default, the goal is in basic Points. The goal can also be a function if its value changes.

  • currencyDisplayName: deprecated. the name to display for the currency for the goal

  • currencyInternalName: deprecated. the internal name for that currency

  • currencyLayer: deprecated. the internal name of the layer that currency is stored in. If it's not in a layer, omit. If it's not stored directly in a layer, instead use the next feature.

  • currencyLocation(): deprecated. if your currency is stored in something inside a layer (e.g. a buyable's amount), you can access it this way. This is a function returning the object in "player" that contains the value (like player[this.layer].buyables)

- + \ No newline at end of file diff --git a/public/lit/docs/clickables.html b/public/lit/docs/clickables.html index 2402977c..b481f528 100644 --- a/public/lit/docs/clickables.html +++ b/public/lit/docs/clickables.html @@ -8,10 +8,10 @@ - + - + @@ -318,7 +318,7 @@ } etc }

Features:

  • title: optional. displayed at the top in a larger font. It can also be a function that returns updating text.

  • effect(): optional. A function that calculates and returns the current values of bonuses of this clickable. Can return a value or an object containing multiple values.

  • display(): A function returning everything that should be displayed on the clickable after the title, likely changing based on its state. Can use basic HTML.

  • unlocked(): optional. A function returning a bool to determine if the clickable is visible or not. Default is unlocked.

  • canClick(): A function returning a bool to determine if you can click the clickable.

  • onClick(): A function that implements clicking one of the clickable.

  • style: optional. Applies CSS to this clickable, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar.

  • id: assigned automagically. It's the "key" which the clickable was stored under, for convenient access. The clickable in the example's id is 11.

You can also use these features on the clickables object to add a button above all the clickables, for implementing a respec button or similar.

  • masterButtonPress(): optional. If present, an additional button will appear above the clickables. Pressing it will call this function.

  • masterButtonText: optional. Text to display on the Master Button.

  • showMasterButton(): optional. A function determining whether or not to show the button. Defaults to true if absent.

- + \ No newline at end of file diff --git a/public/lit/docs/custom-tab-layouts.html b/public/lit/docs/custom-tab-layouts.html index 7f4ee35a..dd218ba3 100644 --- a/public/lit/docs/custom-tab-layouts.html +++ b/public/lit/docs/custom-tab-layouts.html @@ -8,10 +8,10 @@ - + - + @@ -323,7 +323,7 @@ "blank", "upgrades" ]

It is a list of components, which can be either just a name, or an array with arguments. If it's an array, the first item is the name of the component, the second is the data passed into it, and the third (optional) applies a CSS style to it with a "CSS object", where the keys are CSS attributes.

These are the existing components, but you can create more in components.js:

  • display-text: Displays some text (can use basic HTML). The argument is the text to display. It can also be a function that returns updating text.

  • raw-html: Displays some basic HTML, can also be a function.

  • blank: Adds empty space. The default dimensions are 8px x 17px. The argument changes the dimensions. If it's a single value (e.g. "20px"), that determines the height. If you have a pair of arguments, the first is width and the second is height.

  • row: Display a list of components horizontally. The argument is an array of components in the tab layout format.

  • column: Display a list of components vertically. The argument is an array of components in the tab layout format. This is useful to display columns within a row.

  • main-display: The text that displays the main currency for the layer and its effects.

  • resource-display: The text that displays the currency that this layer is based on, as well as the best and/or total values for this layer's prestige currency (if they are put in startData for this layer).

  • prestige-button: The argument is a string that the prestige button should say before the amount of currency you will gain. It can also be a function that returns updating text.

  • upgrades: The layer's upgrades. The argument is optional, and is a the list of rows this component should include, if it doesn't have all of them.

  • milestones, challenges, achievements: Display the upgrades, milestones, and challenges for a layer, as appropriate.

  • buyables, clickables: Display all of the buyables/clickables for this layer, as appropriate. The argument is optional and is the size of the boxes in pixels.

  • microtabs: Display a set of subtabs for an area. The argument is the name of the set of microtabs in the "microtabs" feature.

  • bar: Display a bar. The argument is the id of the bar to display.

  • infobox: Display an infobox. The argument is the id of the infobox to display.

  • tree: Displays a tree. The argument is an array of arrays containing the names of the nodes in the tree (first by row, then by column) See here for more information on tree layouts and nodes!

  • toggle: A toggle button that toggles a bool value. The data is a pair that identifies what bool to toggle, e.g. [layer, id]

The rest of the components are sub-components. They can be used just like other components, but are typically part of another component.

  • upgrade, milestone, challenge, buyable, clickable, achievement: An individual upgrade, challenge, etc. The argument is the id. This can be used if you want to have upgrades split up across multiple subtabs, for example.

  • respec-button, master-button: The respec and master buttons for buyables and clickables, respectively.

  • sell-one, sell-all: The "sell one" and "sell all" for buyables, respectively. The argument is the id of the buyable.

- + \ No newline at end of file diff --git a/public/lit/docs/getting-started.html b/public/lit/docs/getting-started.html index 9fcc9061..8d5a8691 100644 --- a/public/lit/docs/getting-started.html +++ b/public/lit/docs/getting-started.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Getting started ​

Welcome to The Modding Tree!

Using the Modding Tree, at its simplest level, just requires getting a copy of it onto your computer. However, if you do it the right way, it will help in many ways.

Don't let the word "Github" scare you away. It's actually much easier to use than most people think, especially because most people use it the hard way. The key is Github Desktop, which lets you do everything you need to, without even touching the command line.

The benefits of using Github:

  • It makes it much, much easier to update The Modding Tree.
  • You can share your work without any extra effort using githack, or with a bit more effort, set up a github.io site.
  • It lets you undo changes to your code, and to have multiple versions of it.
  • It lets you collaborate with other people, if you want to.

Getting set up with Github Desktop, Visual Studio Code, and The Modding Tree: ​

  1. Install Github Desktop and Visual Studio Code.

  2. Make a Github account. You can handle this on your own.

  3. Log in on your browser, and go back to The Modding Tree page. At the top right, there should be a button that says "fork". Click on it, and then on your username. You now have your own fork, or copy, of The Modding Tree.

  4. Open Github Desktop and log in. Ignore everything else and choose "clone a repository". A "repository" is basically a "Github project", like The Modding Tree. "Cloning" is downloading a copy of the repository to your computer.

  5. Look for The Modding Tree in the list of repositiories (it should be the only one) and click "clone".

  6. Select that you're using it for your own purposes, and click continue. It will download the files and handle everything.

Using your repository ​

  1. Click on "show in explorer/finder" to the right, and then open the index.html file in the folder. The page should open up on your browser. This will let you view and test your project locally!

  2. To edit your project, click "open in VSCode" in Github Desktop.

  3. Open mod.js in VSCode, and look at the top part where it has a "modInfo" object. Fill in your mod's name to whatever you want, and change the id as well. (It can be any string value, and it's used to determine where the savefile is. Make it something that's probably unique, and don't change it again later or else it'll effectively wipe existing saves)

  4. Save mod.js, and then reload index.html in your browser. The title on the tab, as well as on the info page, will now be updated! You can reload the page every time you change the code to test it quickly and easily.

  5. Go back to Github Desktop. It's time to save your changes into the git system by making a "commit". This basically saves your work and creates a snapshot of what your code looks like at this moment, allowing you to look back at it later.

  6. At the bottom right corner, add a summary of your changes, and then click "commit to master".

  7. Finally, at the top middle, click "push origin" to push your changes out onto the online repository.

  8. You can view your project on line, or share it with others, by going to https://raw.githack.com/[YOUR-GITHUB-USERNAME]/The-Modding-Tree/master/index.html

And now, you have successfully used Github! You can look at the documentation to see how The Modding Tree's system works and to make your mod a reality.

- + \ No newline at end of file diff --git a/public/lit/docs/infoboxes.html b/public/lit/docs/infoboxes.html index 235301ef..1daa13c2 100644 --- a/public/lit/docs/infoboxes.html +++ b/public/lit/docs/infoboxes.html @@ -8,10 +8,10 @@ - + - + @@ -317,7 +317,7 @@ }, etc }

Features:

  • title: The text displayed above the main box. Can be a function to be dynamic, and can use basic HTML.

  • body: The text displayed inside the box. Can be a function to be dynamic, and can use basic HTML.

  • style, titleStyle, bodyStyle: optional. Apply CSS to the infobox, or to the title button or body of the infobox, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • unlocked(): optional. A function returning a bool to determine if the infobox is visible or not. Default is unlocked.

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar

  • id: assigned automagically. It's the "key" which the bar was stored under, for convenient access. The infobox in the example's id is "lore".

- + \ No newline at end of file diff --git a/public/lit/docs/layer-features.html b/public/lit/docs/layer-features.html index 7677d6f3..e0eff901 100644 --- a/public/lit/docs/layer-features.html +++ b/public/lit/docs/layer-features.html @@ -8,10 +8,10 @@ - + - + @@ -319,7 +319,7 @@ "challenge"() { return {'height': '200px'} }, "prestige-button"() { return {'color': '#AA66AA'} } }

Custom Prestige type ​

(All of these can also be used by other prestige types)

  • getResetGain(): mostly for custom prestige type. Returns how many points you should get if you reset now. You can call getResetGain(this.layer, useType = "static") or similar to calculate what your gain would be under another prestige type (provided you have all of the required features in the layer).

  • getNextAt(canMax=false): mostly for custom prestige type. Returns how many of the base currency you need to get to the next point. canMax is an optional variable used with Static-ish layers to differentiate between if it's looking for the first point you can reset at, or the requirement for any gain at all (Supporting both is good). You can also call getNextAt(this.layer, canMax=false, useType = "static") or similar to calculate what your next at would be under another prestige type (provided you have all of the required features in the layer).

  • canReset(): mostly for custom prestige type. Return true only if you have the resources required to do a prestige here.

  • prestigeNotify(): mostly for custom prestige types, returns true if this layer should be subtly highlighted to indicate you can prestige for a meaningful gain.

- + \ No newline at end of file diff --git a/public/lit/docs/main-mod-info.html b/public/lit/docs/main-mod-info.html index 556cba8f..c1d50ae7 100644 --- a/public/lit/docs/main-mod-info.html +++ b/public/lit/docs/main-mod-info.html @@ -8,10 +8,10 @@ - + - + @@ -314,7 +314,7 @@ weather: "Yes", happiness: new Decimal(72), }}

  • displayThings: An array of functions used to display extra things at the top of the tree tab. Each function returns a string, which is a line to display (with basic HTML support). If a function returns nothing, nothing is displayed (and it doesn't take up a line).

  • isEndgame(): A function to determine if the player has reached the end of the game, at which point the "you win!" screen appears.

Less important things beyond this point!

  • maxTickLength(): Returns the maximum tick length, in milliseconds. Only really useful if you have something that reduces over time, which long ticks mess up (usually a challenge).
- + \ No newline at end of file diff --git a/public/lit/docs/milestones.html b/public/lit/docs/milestones.html index 0cba88c4..f6718320 100644 --- a/public/lit/docs/milestones.html +++ b/public/lit/docs/milestones.html @@ -8,10 +8,10 @@ - + - + @@ -317,7 +317,7 @@ } etc }

You can use hasMilestone(layer, id) to determine if the player has a given milestone

Milestone features:

  • requirementDescription: A string describing the requirement for unlocking this milestone. Suggestion: Use a "total". It can also be a function that returns updating text. Can use basic HTML.

  • effectDescription: A string describing the reward for having the milestone. You will have to implement the reward elsewhere. It can also be a function that returns updating text. Can use basic HTML.

  • done(): A function returning a boolean to determine if the milestone should be awarded.

  • toggles: optional. Creates toggle buttons that appear on the milestone when it is unlocked. The toggles can toggle a given boolean value in a layer. It is defined as an array of paired items, one pair per toggle. The first is the internal name of the layer the value being toggled is stored in, and the second is the internal name of the variable to toggle. (e.g. [["b", "auto"], ["g", "auto"])

    Tip: Toggles are not de-set if the milestone becomes locked! In this case, you should also check if the player has the milestone.

  • style: optional. Applies CSS to this milestone, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • unlocked(): optional. A function returning a boolean to determine if the milestone should be shown. If absent, it is always shown.

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar.

  • id: assigned automagically. It's the "key" which the milestone was stored under, for convenient access. The milestone in the example's id is 0.

Disaable milestone popups by adding milestonePopups: false to the layer.

- + \ No newline at end of file diff --git a/public/lit/docs/subtabs-and-microtabs.html b/public/lit/docs/subtabs-and-microtabs.html index 12df915e..dcd9270a 100644 --- a/public/lit/docs/subtabs-and-microtabs.html +++ b/public/lit/docs/subtabs-and-microtabs.html @@ -8,10 +8,10 @@ - + - + @@ -334,7 +334,7 @@ // There could be another set of microtabs here } }

Normal subtabs and microtab subtabs both use the same features:

Features: ​

  • content: The tab layout code for the subtab, in the tab layout format.

  • style: optional. Applies CSS to the whole subtab when switched to, in the form of an "CSS Object", where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • buttonStyle: optional. A CSS object, which affects the appearance of the button for that subtab.

  • unlocked(): optional. a function to determine if the button for this subtab should be visible. By default, a subtab is always unlocked. You can't use the "this" keyword in this function.

  • shouldNotify(): optional, if true, the tab button will be highlighted to notify the player that there is something there.

  • embedLayer: SIGNIFICANT, the id of another layer. If you have this, it will override "content", "style" and "shouldNotify", instead displaying the entire layer in the subtab.

- + \ No newline at end of file diff --git a/public/lit/docs/trees-and-tree-customization.html b/public/lit/docs/trees-and-tree-customization.html index c2afd1c1..59d9fb43 100644 --- a/public/lit/docs/trees-and-tree-customization.html +++ b/public/lit/docs/trees-and-tree-customization.html @@ -8,10 +8,10 @@ - + - + @@ -312,7 +312,7 @@

Trees and tree customization ​

If you want to have something beyond the standard tree on the left tab, you can do that in tree.js. You can change the layout of the tree, including making non-layer nodes, change it into something other than a tree, or hide the left tab altogether. This also introduces the "tree" component, which can be used in your layers as well.

layoutInfo ​

The most important part is layoutInfo, containing:

  • startTab: The id of the default tab to show on the left at the start.
  • showTree: True if the tree tab should be shown at the start of the game. (The other tab will fill the whole page)
  • treeLayout: If present, overrides the tree layout and places nodes as you describe instead (explained in the next section).

Additionally, if you want the main layout to not be a tree, you can edit the "tree-tab" layer at the bottom of tree.js to modify it just like a normal layer's tab. You can even switch between left tabs, using showNavTab(layer) to make that layer appear on the left.

Trees ​

The tree component is defined as an array of arrays of names of layers or nodes to show in the tree. They work just like layers/ nodes in the main tree (but branches between nodes will only work on the first node if you have duplicates.)

Here is an example tree:

js
[["p"],
  ["left", "blank", "right", "blank"]
  ["a", "b", "blank", "c", "weirdButton"]]

Nodes ​

Nodes are non-layer buttons that can go in trees. They are defined similarly to layers, but with addNode instead of addLayer.

Features:

  • color: optional, The node's color. (A string in hex format with a #)

  • symbol: optional The text on the button (The id capitalized by default)

  • canClick(): Returns true if the player can click the node. ()

  • onClick(): The function called when the node is clicked.

  • layerShown(): optional, A function returning a bool which determines if this node should be visible. It can also return "ghost", which will hide the layer, but its node will still take up space in its tree.

  • branches: optional. An array of layer/node ids. On a tree, a line will appear from this node to all of the nodes in the list. Alternatively, an entry in the array can be a 2-element array consisting of the id and a color value. The color value can either be a string with a hex color code, or a number from 1-3 (theme-affected colors).

  • nodeStyle: optional. A CSS object, where the keys are CSS attributes, which styles this node on the tree.

  • tooltip() / tooltipLocked(): optional. Functions that return text, which is the tooltip for the node when the layer is unlocked or locked, respectively. By default the tooltips behave the same as in the original Prestige Tree.

  • row: optional, the row that this node appears in (for the default tree).

  • position: optional, Determines the horizontal position of the layer in its row in a default tree. By default, it uses the id, and layers/nodes are sorted in alphabetical order.

- + \ No newline at end of file diff --git a/public/lit/docs/updating-tmt.html b/public/lit/docs/updating-tmt.html index c79bf90a..fe1c6e20 100644 --- a/public/lit/docs/updating-tmt.html +++ b/public/lit/docs/updating-tmt.html @@ -8,10 +8,10 @@ - + - + @@ -310,7 +310,7 @@

Updating The Modding Tree ​

This tutorial assumes that you have used the Getting Started Tutorial, and are using Github Desktop and VSCode for your mod.

Here's what you have to do when there's a TMT update:

  1. Look at the changelog. It will warn you if the update will break anything or require any changes. Decide if you want to try to update.

  2. Open Github Desktop, and at the top middle, click "fetch origin". This will make Github Desktop get information about the update.

  3. Click where it says "current branch: master" at the top middle, and at the bottom of the thing that appears, click "choose a branch to merge into master".

  4. Select upstream/master. It will likely say there are conflicts, but you have tools to resolve them. Click "Merge upstream/master into master".

  5. A conflict happens when the things you're trying to merge have both made changes in the same place. Click "open in Visual Studio Code" next to the first file.

  6. Scroll down through the file, and look for the parts highlighted in red and green. One of these is your code, and the other is some code that will be modified by the update. Do your best to try to edit things to keep the updated changes, but keep your content.

  7. Continue to do this for all remaining changes.

  8. Do any other changes required by the update, run the game, fix issues, etc.

- + \ No newline at end of file diff --git a/public/lit/docs/upgrades.html b/public/lit/docs/upgrades.html index 2b2dd920..2d2892ac 100644 --- a/public/lit/docs/upgrades.html +++ b/public/lit/docs/upgrades.html @@ -8,10 +8,10 @@ - + - + @@ -319,7 +319,7 @@ }, etc }

Each upgrade should have an id where the first digit is the row and the second digit is the column.

Individual upgrades can have these features:

  • title: optional. Displayed at the top in a larger font. It can also be a function that returns updating text. Can use basic HTML.

  • description: A description of the upgrade's effect. You will also have to implement the effect where it is applied. It can also be a function that returns updating text. Can use basic HTML.

  • effect(): optional. A function that calculates and returns the current values of any bonuses from the upgrade. Can return a value or an object containing multiple values.

  • effectDisplay(): optional. A function that returns a display of the current effects of the upgrade with formatting. Default displays nothing. Can use basic HTML.

  • fullDisplay(): OVERRIDE. Overrides the other displays and descriptions, and lets you set the full text for the upgrade. Can use basic HTML.

  • cost: A Decimal for the cost of the upgrade. By default, upgrades cost the main prestige currency for the layer.

  • unlocked(): optional. A function returning a bool to determine if the upgrade is visible or not. Default is unlocked.

  • onPurchase(): optional. This function will be called when the upgrade is purchased. Good for upgrades like "makes this layer act like it was unlocked first".

  • style: optional. Applies CSS to this upgrade, in the form of an object where the keys are CSS attributes, and the values are the values for those attributes (both as strings).

  • layer: assigned automagically. It's the same value as the name of this layer, so you can do player[this.layer].points or similar.

  • id: assigned automagically. It's the "key" which the upgrade was stored under, for convenient access. The upgrade in the example's id is 11.

By default, upgrades use the main prestige currency for the layer. You can include these to change them (but it needs to be a Decimal):

  • currencyDisplayName: optional. The name to display for the currency for the upgrade.

  • currencyInternalName: optional. The internal name for that currency.

  • currencyLayer: optional. The internal name of the layer that currency is stored in. If it's not in a layer (like Points), omit. If it's not stored directly in a layer, instead use the next feature.

  • currencyLocation: optional. If your currency is stored in something inside a layer (e.g. a buyable's amount), you can access it this way. This is a function returning the object in "player" that contains the value (like player[this.layer].buyables)

If you want to do something more complicated like upgrades that cost two currencies, you can override the purchase system with these (and you need to use fullDisplay as well)

  • canAfford(): OVERRIDE, a function determining if you are able to buy the upgrade

  • pay(): OVERRIDE, a function that reduces your currencies when you buy the upgrade

- + \ No newline at end of file