diff --git a/docs/scarpet/Full.md b/docs/scarpet/Full.md
index 453307fa..601eadd2 100644
--- a/docs/scarpet/Full.md
+++ b/docs/scarpet/Full.md
@@ -431,9 +431,16 @@ $);
 Allows to add the results of two expressions. If the operands resolve to numbers, the result is arithmetic operation. 
 In case of strings, adding or subtracting from a string results in string concatenation and removal of substrings 
 from that string. Multiplication of strings and numbers results in repeating the string N times and division results 
-in taking the first k'th part of the string, so that `str*n/n ~ str` In case first operand is a list, either it 
+in taking the first k'th part of the string, so that `str*n/n ~ str` 
+
+In case first operand is a list, either it 
 results in a new list with all elements modified one by one with the other operand, or if the operand is a list 
-with the same number of items - element-wise addition/subtraction
+with the same number of items - element-wise addition/subtraction. This prioritize treating lists as value containers
+to lists treated as vectors.
+
+Addition with maps (`{}` or `m()`) results in a new map with keys from both maps added, if both operands are maps,
+adding elements of the right argument to the keys, of left map, or just adding the right value as a new key
+in the output map. 
 
 Examples:
 
@@ -447,6 +454,7 @@ Examples:
 'foofoofoo'-'o' => 'fff'
 l(1,2,3)+1  => l(2,3,4)
 b = l(100,63,100); b+l(10,0,10)  => l(110,63,110)
+{'a' -> 1} + {'b' -> 2} => {'a' -> 1, 'b' -> 2}
 </pre>
 
 ### `Just Operators % ^`
diff --git a/docs/scarpet/language/Operators.md b/docs/scarpet/language/Operators.md
index 6d78efd6..c552a2fc 100644
--- a/docs/scarpet/language/Operators.md
+++ b/docs/scarpet/language/Operators.md
@@ -110,9 +110,16 @@ $);
 Allows to add the results of two expressions. If the operands resolve to numbers, the result is arithmetic operation. 
 In case of strings, adding or subtracting from a string results in string concatenation and removal of substrings 
 from that string. Multiplication of strings and numbers results in repeating the string N times and division results 
-in taking the first k'th part of the string, so that `str*n/n ~ str` In case first operand is a list, either it 
+in taking the first k'th part of the string, so that `str*n/n ~ str` 
+
+In case first operand is a list, either it 
 results in a new list with all elements modified one by one with the other operand, or if the operand is a list 
-with the same number of items - element-wise addition/subtraction
+with the same number of items - element-wise addition/subtraction. This prioritize treating lists as value containers
+to lists treated as vectors.
+
+Addition with maps (`{}` or `m()`) results in a new map with keys from both maps added, if both operands are maps,
+adding elements of the right argument to the keys, of left map, or just adding the right value as a new key
+in the output map. 
 
 Examples:
 
@@ -126,6 +133,7 @@ Examples:
 'foofoofoo'-'o' => 'fff'
 l(1,2,3)+1  => l(2,3,4)
 b = l(100,63,100); b+l(10,0,10)  => l(110,63,110)
+{'a' -> 1} + {'b' -> 2} => {'a' -> 1, 'b' -> 2}
 </pre>
 
 ### `Just Operators % ^`
diff --git a/src/main/java/carpet/script/value/MapValue.java b/src/main/java/carpet/script/value/MapValue.java
index f6332b4d..099206d2 100644
--- a/src/main/java/carpet/script/value/MapValue.java
+++ b/src/main/java/carpet/script/value/MapValue.java
@@ -97,8 +97,24 @@ public class MapValue extends AbstractListValue implements ContainerValueInterfa
     @Override
     public Value add(Value o)
     {
-        append(o);
-        return this;
+        Map<Value, Value> newItems = new HashMap<>(map);
+        if (o instanceof MapValue)
+        {
+            newItems.putAll(((MapValue) o).map);
+        }
+        else if (o instanceof AbstractListValue)
+        {
+            Iterator<Value> it = ((AbstractListValue) o).iterator();
+            while (it.hasNext())
+            {
+                newItems.put(it.next(), Value.NULL);
+            }
+        }
+        else
+        {
+            newItems.put(o, Value.NULL);
+        }
+        return MapValue.wrap(newItems);
     }
 
     @Override